Hi all,
At the OARC 45 meeting, we announced the start of creating a group
inside the OARC community to create a DNS Best Current Practices set of
documents:
https://indico.dns-oarc.net/event/55/contributions/1203/
Now there is an infrastructure available to facilitate this work. The
source of the documents are being maintained inside a GitLab subproject at:
https://gitlab.com/DNS-OARC/bcp
A few important things to do were to explain the goals of this
initiative, and define process structure. I started a first BCP project
titled "How to write DNS-OARC BCP documents" to document this:
https://gitlab.com/DNS-OARC/bcp/0000-howto-bcp
The project is hooked up with "Read the Docs" and the document can be
read here:
https://oarc-bcp-0000.readthedocs.io
This is a living document, as BCP documents tend to be, so I encourage
you to read it, and to participate. You can do so, ideally by creating
merge requests and issues at the GitLab project, as the document
currently explains, or otherwise by sending an e-mail to
[email protected], or by using the DNS-OARC Mattermost
instance. There is a dedicated channel there:
https://chat.dns-oarc.net/community/channels/dns-bcp
There are in fact already two issues on the document:
https://gitlab.com/DNS-OARC/bcp/0000-howto-bcp/-/issues
One is about what markup language to use. Personally, I started with
RestructedText, but perhaps Markdown is easier to use, lower bar and all?
The other is whether the current infrastructure, where every document is
maintained in a separate project is the right choice, or if all BCP
documents should live in a single project.
We welcome feedback from the community on these issues, as well as on
the whole setup.
Best regards,
Matthijs
_______________________________________________
dns-operations mailing list
[email protected]
https://lists.dns-oarc.net/mailman/listinfo/dns-operations
