Skip to main content

About GitHub's documentation fundamentals

All content published on GitHub Docs must meet these fundamental requirements.

About GitHub's documentation fundamentals

These fundamentals are required for GitHub documentation. Use the lists below to help ensure your contributions are accurate, accessible and inclusive, and consistent.

Accurate

Documentation is correct and accurate.

  • Ensure that the content is free from factual errors.
  • Ensure that the content is free from spelling and formatting errors.

Accessible and inclusive

Documentation is up to date with the latest accessibility standards, and is written to be inclusive and translation-friendly.

Consistent

Documentation maintains a consistent voice, tone, and style throughout, creating a cohesive experience for readers.

  • Ensure content adheres to the GitHub Docs style guide. For more information, see "Styleguide."
  • Apply consistent terminology and naming conventions.
  • Use branding elements (for example, product and feature names, logos, color schemes) consistently in the content.