Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Recommendation #3:  We recommend that the dci-lint tool that Peter Somogyvari wrote be implemented across all Hyperledger repos. The goal of the dci-lint tool is for projects to be able to detect any language changes. This tool helps remove a barrier to entry for updating language in the projects to be more inclusive. Hyperledger staff is prepared to push this out across the various repos with no effort from maintainers. The tool does not specify which language changes to make, but it makes the process easier to implement any changes the projects would like.

...

  1. The DCI Working Group will present at a Maintainer Onboarding Meeting these DCI Recommendations to train and inform the maintainers of these best practices. We want to inform the community of the value of these practices, but also train them on how to implement them easily in their projects.
  2. Leverage the DCI Working Group to share this proposal in several forums, in addition to the Maintainer meeting, including the devweekly newsletter, project contributor meetings, etc.
  3. Add to the quarterly report template the question, "Has your project implemented these inclusive language changes listed below to your repo? Yes/No?" We will include a link to this page in which the project can download get started with the linter tool to assist if they want to use it. The changes include:
    1. master → main
    2. slave → replicas
    3. blacklist → denylist
    4. whitelist → allowlist
  4. Add to the quarterly report template, "Have you added an Inclusive Language Statement to your project's documentation and/or Wiki pages?" We will include this paragraph as an example. 

    Inclusive Language: 

    • Consider that users who will read the docs are from different background and cultures and that they have different preferences.
    • 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 Microsoft bias free writing guidelines and Google inclusive doc writing guide as starting points.

...

...