[GitHub] [pulsar-site] tisonkun commented on pull request #207: fix docs banner text

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

tisonkun commented on PR #207:
URL: https://github.com/apache/pulsar-site/pull/207#issuecomment-1240851245

   Hi @Anonymitaet 
   
   > For the latest stable doc version (eg. 2.10.x):
   > 
   > This is the latest stable version [2.10.x](https://github.com/apache/pulsar-site/pull/URL-placeholder).
   
   I don't think we need a banner for the (expected) latest stable doc.
   
   Agree on other wording changes.
   
   > Blue is more appropriate than yellow/red here.
   >
   > Yellow / red can be used to indicate important hints, tips, guidance, restrictions, advice that might be overlooked, or the possibility of damage to software.
   >
   > If yellow / red is overused, they lose their significance.
   
   Here we'd like to hint the users to use the latest stable doc. So it's not overuse from my perspective. You can get the image why it's a hint from:
   
   * https://nightlies.apache.org/flink/flink-docs-release-1.12/
   * https://docusaurus.io/docs/2.0.1
   
   You _can_ find several projects that don't follow this way. But think of the Pulsar situation - we don't maintain quite a few old versions, and it's still under rapid development. We don't want users to use an old version and ask for bug fixes cherry-pick, but just try out the latest stable. For users already use an old version, the color is not a big deal.


-- 
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