Why Some Pages Accessible Via URL But Not Nav?

[wesleyboar]

Question

Why can several pages load via URL, but do not show up in nav sidebar?

Actual Result

URL	Nav (Top)	Nav (Bottom)
https://www.designsafe-ci.org/user-guide/usecases/arduino/usecase/
https://www.designsafe-ci.org/user-guide/usecases/dawson/usecase/
https://www.designsafe-ci.org/user-guide/dictionary/experimental/

Expected Result

URL	Nav (Active)
https://www.designsafe-ci.org/user-guide/usecases/windstormsurgeusecases/

[wesleyboar]

I asked around, and got the following answers:

• It is intentional, because we did not want too much to show in the navigation.
• The materials are very deeply nested, so navigation can get deep quickly.
• Reorganization made nav "flatter", but nav could still get "too long". ^{We have some very long docs, because they had been individual docs.}
• Some files may exist only as "a backup" not meant to be shown in nav.
• There was a lot of duplication in the documentation.

I think there is a way to:

• show everything (except duplicates)
• limit navigation depth
• offer ways to navigate docs deeper than the nav shows

Super long docs may still be a problem. It is a problem on https://docs.tacc.utexas.edu also. I propose revisiting after redesign (#1).

[silviamazzoni]

I resolved the first one with Pedro's. he hadn't put in the title # OpenSees Model Calibration, which is what the nav page referred to.

[silviamazzoni]

the page that collates them does two things, 1. collates them, 2 adds the bookmarks to the nav bar. but the bookmark that it was using wasn't found in the collated page

[wesleyboar]

As an issue written and labeled as a question, I think we've both answered this (above), so I'll close it.

Answer Summary: A mix of navigation usage[^1], navigation gotchas[^1], duplicate docs[^2], and either neglect or lack of authority to resolve. I've gotten approval to work with contributors and designer to resolve this, so expect progress.

[^1]: Both @silviamazzoni and @wesleyboar are aware of navigation usage and gotchas and what are options are.

[wesleyboar]

New instances of the problem were recently introduced.