documentation icon indicating copy to clipboard operation
documentation copied to clipboard

Patterns: reduce annoyance for writers of having a flat folder?

Open Eric-Arellano opened this issue 3 months ago • 0 comments

Having all the guides in a single flat "guides" folder makes it more annoying for writers to work with: https://github.com/Qiskit/documentation/pull/1294.

Note that the URLs should be flat, like guides/my-file, not guides/my-folder/my-file. But it's annoying to be flat with the docs behind-the-scenes.

Fixing this would require some new mechanisms from the docs app to have files not colocated with the _toc.json. It's unclear how complex this would be.

Eric-Arellano avatar May 03 '24 20:05 Eric-Arellano