Anonymitaet commented on code in PR #18379: URL: https://github.com/apache/pulsar/pull/18379#discussion_r1016196954
########## site2/docs/developer-landing.md: ########## @@ -0,0 +1,17 @@ +--- +Id: developers-landing +title: Pulsar for Developers +sidebar_label: “get started” Review Comment: `"` is correct (not `“` or `”`) ########## site2/docs/how-to-landing.md: ########## @@ -0,0 +1,16 @@ +--- +Id: how-to-landing +title: How-to Review Comment: Do we need more explanations for `title`? Does `How-to` provide too limited info? ########## site2/docs/developer-landing.md: ########## @@ -0,0 +1,17 @@ +--- +Id: developers-landing +title: Pulsar for Developers +sidebar_label: “get started” +--- + +Developing applications for Pulsar can be a fun and rewarding experience. With Pulsar, you can quickly create, deploy, and manage your services using a powerful CLI tool and a comprehensive set of libraries. The topics below will get you started! + +[Simulation tools](develop-tools") Review Comment: `develop-tools"` is not a correct path ########## site2/docs/how-to-landing.md: ########## @@ -0,0 +1,16 @@ +--- +Id: how-to-landing +title: How-to +sidebar_label: “” Review Comment: ditto ########## site2/docs/install-deploy-upgrade-landing.md: ########## @@ -0,0 +1,18 @@ +--- +Id: install-deploy-upgrade-landing +title: Install-Deploy-Upgrade Review Comment: ```suggestion title: Install, deploy, and upgrade Pulsar ``` 1. Do we need to make it more natural? 2. Do we need to split it into independent chapters? (that is, one chapter for `install`, one for `deploy`, and one for `upgrade`?) ########## site2/docs/how-to-landing.md: ########## @@ -0,0 +1,16 @@ +--- +Id: how-to-landing +title: How-to +sidebar_label: “” +— + +Learning new software can be an overwhelming task, but relax – most aspects of Pulsar can be easily configured in just a few steps. These tutorials will show you how to quickly create topics, tenants, and namespaces, produce and consume messages, and more! Review Comment: ```suggestion Learning new software can be an overwhelming task, but relax – most aspects of Pulsar can be easily configured in just a few steps. These tutorials show you how to quickly create topics, tenants, and namespaces, produce and consume messages, and more! ``` Write in the simple present tense as much as possible if you are covering facts that were, are, and forever shall be true. https://docs.google.com/document/d/1lc5j4RtuLIzlEYCBo97AC8-U_3Erzs_lxpkDuseU0n4/edit#bookmark=id.e8uqh1awkcnp -- 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]
