Following up on #323, it is now possible to migrate from github to cgit.f.o/doc, but there's a couple of things that need to be addressed before this can happen, if it is to happen.
First, we need to address the elephant in the room, which is that there's no longer any pull requests.
For commiters, means they'll need approval for adding to the status report folder - this can, and should, be a blanket approval for any file which isn't _index.adoc (doceng@ may need to approve this?).
It it helped along by the tooling available, in that textproc/rubygem-asciidoctor can serve as a linter, and reviews.f.o can be used as a staging area for collaborative entries, which itself is helped along by src/tools/tools/git/git-arc.sh and it's manual page which are available simply by doing make build
and make install
For contributors, this means suggesting either using reviews.f.o for easy feedback from the status report team, or collaboration with other contributors, or the use of git format-patch
to craft patches can be sent via email, as this creates mailbox format patch (which can be applied with git am
) that keeps the all the relevant meta-data.
All of the necessary information should be collected in status/howto.adoc which should be accessible from here or somewhere equally centrally located. @sergio-carlavilla should probably be involved, since at present the howto doesn't appear to work.