Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Unlinked/dead pages #173

Closed
felker opened this issue Mar 2, 2023 · 4 comments · Fixed by #246
Closed

Unlinked/dead pages #173

felker opened this issue Mar 2, 2023 · 4 comments · Fixed by #246
Assignees

Comments

@felker
Copy link
Member

felker commented Mar 2, 2023

INFO     -  The following pages exist in the docs directory, but are not
            included in the "nav" configuration:
              -
            account-project-management/allocation-management/sbank-detail-allocations.md
              -
            account-project-management/allocation-management/sbank-detail-jobs.md
              -
            account-project-management/allocation-management/sbank-detail-projects.md
              -
            account-project-management/allocation-management/sbank-detail-transactions.md
              -
            account-project-management/allocation-management/sbank-detail-users.md
              - account-project-management/allocation-management/sbank-detail.md
              -
            account-project-management/allocation-management/sbank-examples.md
              -
            account-project-management/allocation-management/sbank-list-allocations.md
              -
            account-project-management/allocation-management/sbank-list-jobs.md
              -
            account-project-management/allocation-management/sbank-list-projects.md
              -
            account-project-management/allocation-management/sbank-list-transactions.md
              -
            account-project-management/allocation-management/sbank-list-users.md
              - account-project-management/allocation-management/sbank-list.md
              -
            account-project-management/allocation-management/sbank-manpage.md
              - ai-testbed/howto-contribute.md
              - ai-testbed/habana/getting-started.md
              - ai-testbed/sambanova/TODO.md
              - ai-testbed/sambanova/performance-tools.md
              - ai-testbed/sambanova/readme-rick.md
              - ai-testbed/sambanova/readme.md
              - ai-testbed/sambanova/readme_rick_02.md
              - ai-testbed/sambanova/sambanova.md
              - ai-testbed/sambanova/sambatune-user-guide.md
              - polaris/compiling-and-linking/continuous-integration-polaris.md
              - polaris/debugging-tools/debugging-overview.md
              - polaris/performance-tools/performance-overview.md
              - running-jobs/gronkulator.md
              - running-jobs/pbs-admin-quick-start-guide.md
              - services/index.md
              - theta/debugging-tools/debugging-overview.md

Some of these (AI Testbed, Gronkulator) make sense, since they are not ready for primetime. But all of the sbank pages seem stale. Should we remove them?

@bethcerny
Copy link
Collaborator

Keep these. All the sbank command pages are referenced in sbank pages that are linked.

Not sure what’s going on with the Polaris pages or running jobs. You’d have to ask Bill or whoever authored them.

@weallcock
Copy link
Contributor

weallcock commented Mar 3, 2023 via email

@felker
Copy link
Member Author

felker commented Mar 3, 2023

No worries, just checking that the current situation is intended, and no pages are unintentionally orphaned. I wonder if Mkdocs has the ability to detect of .md files are neither in the Nav nor linked to by other docs...

In particular, wondering if these are supposed to be in the Nav:

              - polaris/compiling-and-linking/continuous-integration-polaris.md
              - polaris/debugging-tools/debugging-overview.md
              - polaris/performance-tools/performance-overview.md
              - running-jobs/gronkulator.md
              - services/index.md
              - theta/debugging-tools/debugging-overview.md

@felker
Copy link
Member Author

felker commented Jul 28, 2023

Closing via #246

@felker felker closed this as completed Jul 28, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
3 participants