freedomofpress / freedomofpress/securedrop-dev-docs
Add "virtual environments" section in navigation bar
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 6
- Forks
- 4
- Avg merge
- 2h 22m
- Merged PRs (30d)
- 1
Description
Describe the change
I propose to move these pages from the navigation section "Developer documentation" to a new section above called "Virtual Environments":
- Virtual environments: Servers
- Virtual environments: Admin Workstation
- Virtual environments: Using Qubes
- Portable SecureDrop Demo
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?
- I think that a less crowded "Developer documentation" section would be beneficial for everyone
- New administrators won't have to look through all the documentation before finding what they need to have a virtualized environment for evaluation purposes. At the same time developers won't have any difficulty in finding what they need even if it's not in "their" section. Win-win
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
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the navigation configuration for the "Developer documentation" section and the four listed pages. Move those pages into a separate "Virtual Environments" section above it, then verify that the navigation is less crowded and all four pages remain easy to find.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100