Open bamarsha opened 2 years ago
@bettinaheim do you have any thoughts on the process and how to prevent the docs repo from becoming out of sync?
And just to clarify/rephrase, but my understanding of the situation is:
IMO this split is kind of weird, and ideally I'd prefer everything to be done all in one repo. Or it would be nice if it was clearly documented and checked in CI for the second case.
To get the language docs to show up in the user guide at https://docs.microsoft.com/en-us/azure/quantum/user-guide/, there are stubs and a UID mapping defined for each page here: https://github.com/MicrosoftDocs/quantum-docs/tree/main/articles/user-guide/language
However, if pages are added or removed, the stubs don't seem to be updated automatically. It's not clear to me what the process is for updating them and it doesn't seem to be described in this repo. I think it would be better to: