Open damko opened 3 years ago
@damko These virtual environments are only intended for development, so we do want to keep them clearly situated in the dev docs. That said, the information architecture of the development section of the docs definitely needs improvement.
@eloquence yes, on a second analysis, I reached your same conclusion. It should stay in the development section however I still felt the need for a "hit the ground running" kind of tutorial which would satisfy the needs of those willing to evaluate SecureDrop so I wrote it (currently ~70% of the draft). I'm writing it while I build my own "evaluation environment". When completed I'll submit it as a ticket so that you guys can have a look at it and understand if it's something desirable.
Describe the change
I propose to move these pages from the navigation section "Developer documentation" to a new section above called "Virtual Environments":
Eventually the page files could be moved to a separate folder like "venvs" but, what's important to me is to have a separate section like this:
How will this impact users?
User Research Evidence
I'm new to Securedrop at it was hard for me to navigate the documentation. Only after two days with my nose in the documentation I realized that a portable setup is described: I simply couldn't see it.
Additional context