[GitHub] [pulsar-site] Anonymitaet commented on a diff in pull request #207: fix docs banner text

[GitBox <gi...@apache.org>]

Anonymitaet commented on code in PR #207:
URL: https://github.com/apache/pulsar-site/pull/207#discussion_r965805613


##########
site2/website-next/scripts/code.json:
##########
@@ -0,0 +1,501 @@
+{
+  "Subscribe": {
+    "message": "Subscribe"
+  },
+  "Unsubscribe": {
+    "message": "Unsubscribe"
+  },
+  "Archives": {
+    "message": "Archives"
+  },
+  "Release Notes": {
+    "message": "Release Notes"
+  },
+  "Documentation": {
+    "message": "Documentation"
+  },
+  "theme.navbar.mobileVersionsDropdown.label": {
+    "message": "Versions",
+    "description": "The label for the navbar versions dropdown on mobile view"
+  },
+  "Contact": {
+    "message": "Contact"
+  },
+  "There are many ways to get help from the Apache Pulsar community. The mailing lists are the primary place where all Pulsar committers are present. Bugs and feature requests can either be discussed on the dev mailing list or by opening an issue on": {
+    "message": "There are many ways to get help from the Apache Pulsar community. The mailing lists are the primary place where all Pulsar committers are present. Bugs and feature requests can either be discussed on the dev mailing list or by opening an issue on"
+  },
+  "Mailing Lists": {
+    "message": "Mailing Lists"
+  },
+  "Stack Overflow": {
+    "message": "Stack Overflow"
+  },
+  "For technical questions, we ask that you post them to": {
+    "message": "For technical questions, we ask that you post them to"
+  },
+  "using the tag “apache-pulsar”.": {
+    "message": "using the tag “apache-pulsar”."
+  },
+  "Slack": {
+    "message": "Slack"
+  },
+  "There is a Pulsar slack channel that is used for informal discussions for devs and users.": {
+    "message": "There is a Pulsar slack channel that is used for informal discussions for devs and users."
+  },
+  "The Slack instance is at": {
+    "message": "The Slack instance is at"
+  },
+  "You can self-register at": {
+    "message": "You can self-register at"
+  },
+  "WeChat": {
+    "message": "WeChat"
+  },
+  "There are several WeChat groups that are used for informal discussions for devs and users.": {
+    "message": "There are several WeChat groups that are used for informal discussions for devs and users."
+  },
+  "To join these WeChat tech groups, you can add Bot with the WeChat ID: StreamNative_BJ": {
+    "message": "To join these WeChat tech groups, you can add Bot with the WeChat ID: StreamNative_BJ"
+  },
+  "Apache Pulsar downloads": {
+    "message": "Apache Pulsar downloads"
+  },
+  "Release notes": {
+    "message": "Release notes"
+  },
+  "Current version (Stable)": {
+    "message": "Current version (Stable)"
+  },
+  "Tiered storage offloaders": {
+    "message": "Tiered storage offloaders"
+  },
+  "Pulsar IO connectors": {
+    "message": "Pulsar IO connectors"
+  },
+  "Release Integrity": {
+    "message": "Release Integrity"
+  },
+  "Getting started": {
+    "message": "Getting started"
+  },
+  "Once you've downloaded a Pulsar release, instructions on getting up and running with a standalone cluster that you can run on your laptop can be found in the": {
+    "message": "Once you've downloaded a Pulsar release, instructions on getting up and running with a standalone cluster that you can run on your laptop can be found in the"
+  },
+  "Run Pulsar locally": {
+    "message": "Run Pulsar locally"
+  },
+  "tutorial": {
+    "message": "tutorial"
+  },
+  "If you need to connect to an existing Pulsar cluster or instance using an officially supported client, see the client docs for these languages:": {
+    "message": "If you need to connect to an existing Pulsar cluster or instance using an officially supported client, see the client docs for these languages:"
+  },
+  "Older releases": {
+    "message": "Older releases"
+  },
+  "Pulsar Adapters": {
+    "message": "Pulsar Adapters"
+  },
+  "Pulsar Adapters are available on Maven Central, there is no binary package.": {
+    "message": "Pulsar Adapters are available on Maven Central, there is no binary package."
+  },
+  "Apache Pulsar Manager downloads": {
+    "message": "Apache Pulsar Manager downloads"
+  },
+  "Pulsar Manager older releases": {
+    "message": "Pulsar Manager older releases"
+  },
+  "Latest Stable Version": {
+    "message": "Latest Stable Version"
+  },
+  "Latest Version": {
+    "message": "Latest Version"
+  },
+  "Here you can find the latest documentation and unreleased code.": {
+    "message": "Here you can find the latest documentation and unreleased code."
+  },
+  "Past Version": {
+    "message": "Past Version"
+  },
+  "Here you can find documentation for previous versions of Apache Pulsar.": {
+    "message": "Here you can find documentation for previous versions of Apache Pulsar."
+  },
+  "theme.docs.versions.unreleasedVersionLabel": {
+    "message": "This documentation is for an unreleased {siteTitle} {versionLabel} version of Apache Pulsar. ",
+    "description": "The label used to tell the user that he's browsing an unreleased doc version"
+  },
+  "theme.docs.versions.unmaintainedVersionLabel": {
+    "message": "This documentation is for an out-of-date {siteTitle} {versionLabel} version of Apache Pulsar. ",
+    "description": "The label used to tell the user that he's browsing an unmaintained doc version"
+  },
+  "theme.docs.versions.latestVersionSuggestionLabel": {
+    "message": "We recommend you use the {latestVersionLink} ({versionLabel}).",

Review Comment:
   In technical writing:
   
   - Avoid first-person pronouns. Details see https://docs.google.com/document/d/1lc5j4RtuLIzlEYCBo97AC8-U_3Erzs_lxpkDuseU0n4/edit#bookmark=id.gfwms5zehcak. 
   - Avoid using "recommend" if possible. A phrase such as “We recommend that you take the following action” could create a potential marketing or legal problem



-- 
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: commits-unsubscribe@pulsar.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org