#9 Should we merge this repo with ``documentation-contributors-guide``?
Opened a year ago by ojn. Modified 5 months ago

I'm not sure if the separation makes sense, my suggestion https://pagure.io/fedora-docs/template/issue/5#comment-532233 was that we would agree on one versioned standard on how the documentation is produced and generated.

Also for the name of such repo I would suggest that we use fedora-docs/documentation-guidelines to not have any ambiguity on what we are referring to. Let's say we produce a guide document pdf we should call it Documentation Guide that would distinguish the Guidelines (the content and repository) from the guide itself (i.e the document). It would make it easier to say that document "adheres to the Documention Guidelines - revision 0.1" which may or may not be a part of the final document.

Hi, yes, the separation is a problem. It happened because we needed instructions for working for Antora ASAP, and I wanted to keep them separate from this repo because this one needs a revision and it would take time. I'll get rid of this guide soon and move all the info back into the updated Contributor's Guide.

Hey, I wanted to follow up here. I was confused by the same thing until I saw this issue. I have been linking here for docs guidelines for a while without realizing the difference.

Login to comment on this ticket.