How to write DNS-OARC BCP documents

This document serves as a guidance on how to write new DNS-OARC best currrent practice (BCP) documents, as well as how they are maintained.

Note

This project is under active development.

Version: 0.3.1

Shepherd: Matthijs Mekking

Latest assessment: 2026-06-23

License

This document is licensed under CC BY-SA 4.0. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/4.0/

Contents

• Objectives
  • Deliverables
• Requirements
  • Document requirements
• Methodology
  • Process Structure
  • Roles
    • Curator
    • Shepherd
    • Contributor
    • Reviewer
• Starting a New BCP
  • Creating a New Project
    • Licensing
  • Importing the Project into Read the Docs
  • Configuring the Project
    • Adding Maintainers
    • Pull request builds
    • Setting Up Email Notification
• Updating Documents
  • A New Branch
  • Discussion Topics
  • Merge Requests
    • Fork Project
    • Create Working Branch
    • Create Merge Request
  • Reviewing
  • Versioning
    • Stable versions
    • Minor versions
    • Changelog
• Testing
  • Build Pipelines
  • Operational Testing
• Acknowledgements