Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updates according to suggestions

...

To provide additional detail, use sub-sections.

5. Be Inclusive

We believe that we all have a role to play to improve our world and writing inclusive doc is a first step in the right direction.

We welcome users and contributors from a wide range of of cultures, so please remember to always observe and respect their preferred language around their identity. Consider that users who will read the docs are from different background and cultures and that they have different sensitivities.

Avoid potential offensive terms and, for instance, prefer "allow list and deny list" to "white list and black list".We believe that we all have a role to play to improve our world, and even if writing inclusive doc might not look like a huge improvement, it's a first step in the right direction.

We suggest to refer to Google inclusive doc writing guide and Microsoft bias free writing guidelines as starting points.

...