1. Home
  2. Docs
  3. Style Guide
  4. General Writing Principle...
  5. Timeless Documentation

Timeless Documentation

Timeless documentation is designed to remain relevant and useful long after it is written. This approach minimises the need for frequent updates and ensures users can rely on the documentation over time.

  1. Avoid Date-Specific Language
    Refrain from using phrases like “currently,” “recently,” or “in the future,” which can quickly become outdated. Instead, use specific timeframes (e.g., “As of August 2024”) or avoid mentioning time altogether if it’s not essential.
  2. Version Control:
    Clearly indicate the version of the product or software that the documentation applies to. This helps users understand whether the information is relevant to their situation.
  3. Modular Content:
    Write content in a modular way so that individual sections can be updated independently of the entire document. This approach allows for easier maintenance and ensures quick and efficient updates.
  4. Future-Proofing:
    When describing features or functionality, consider potential future changes and write in a way that minimises the need for updates. For example, instead of saying, “The button is green,” you might say, “The button is located at the top right of the screen.”