Anonymitaet commented on pull request #12902: URL: https://github.com/apache/pulsar/pull/12902#issuecomment-983228833
> @Anonymitaet > > Please don't block the PR due to the documentation format. yes, I agree, the better format helps but the reorganization of the content can be handled in separate PR as well because every individual has a different idea about the formation. Hi @rdhabalia, - I did not mean to block anything, I just want to improve the user experience since no one would like to read "a mountain of" information at a glance. Technical information should be easy to find/understand/use. - Agree that documentation can be submitted in a separate PR. - Everyone has a different opinion on everything but there are some general rules/standards accepted by the majority. In technical writing, often, text that is difficult to understand in paragraph form becomes clear in a table format. Tables help highlight relationships among similar pieces of information and are easily scanned for quick reference. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
