Conversation
Thinking out loud: would it make sense to establish a rule to have a topic/area prefix for everything? The possibility of similar headings seems high across the board.
By this, you mean, for example, removing a MIR item from one index.md and adding it to another? If yes, then no -- the check would only be triggered if the actual bits (the MIR file) change. It's on Git level, and Git doesn't care (doesn't know) what happens with the files when Sphinx builds the docs. |
rkratky
left a comment
There was a problem hiding this comment.
A couple of nits. Pre-approved.
The more I've been looking at the wiki content, the more I think that seems like a sensible approach. Many of the headings within pages are repetitive, and if we're splitting pages apart then chances are we'll run across duplicates that have to be disambiguated.
That is what I meant - thanks for clarifying my expectations :) |
This PR moves the MIR docs from being displayed in the staging area to being part of the actual docs. I have not added contextual text to most of the landing pages, as the pages themselves may be moved, but I have included a sample of the sort of thing we could have on the how-to/archive-admin/index page.
Some things to note:
docs/MIR/to simplify the ACL setup. Any page added to this folder will be subject to the ACL check, rather than setting the controls on individual pages.The next step is to actually set up the ACLS -- then I will do the wording changes discussed with cpaelzer so that the MIR team can review them.