Skip to content

docs(admin): Adjust + automate ordering of Configuration chapter #11691

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

Merged
merged 1 commit into from
Apr 3, 2024

Conversation

joshtrichards
Copy link
Member

@joshtrichards joshtrichards commented Apr 2, 2024

Make sure the following are always first:

  • "Warnings on admin page"
  • "Using the occ command"
  • "Configuration Parameters"

Then:

  • Include everything else automatically using glob (i.e. without require this index.rst be updated when adding new sections)
  • Automatically alphabetize glob included sections

Note: At the moment it alphabetizes based on the underlying filename so some of the glob added ones will still have a funny order, but my primary motivation for this change was to pull Configuration Parameters out of hiding. The auto-adding and alphabetizing was more a bonus.

☑️ Resolves

🖼️ Screenshots

image

Make sure the following are always first:

- "Using the occ command"
- "Configuration Parameters"
- "Warnings on admin page"
- Then include everything else left automatically (without require this index be updated for every new section any longer)
- Automatically alphabetize included sections

Signed-off-by: Josh <josh.t.richards@gmail.com>
@joshtrichards joshtrichards force-pushed the docs/admin/configuration-chapter-toc branch from 4252094 to f5d5d1d Compare April 2, 2024 16:58
@joshtrichards joshtrichards marked this pull request as ready for review April 2, 2024 17:07
@joshtrichards joshtrichards changed the title docs(admin): Update + automate ordering of Configuration chapter docs(admin): Adjust + automate ordering of Configuration chapter Apr 2, 2024
@joshtrichards
Copy link
Member Author

/backport to stable29

@joshtrichards
Copy link
Member Author

/backport to stable28

Copy link
Contributor

Hello there,
Thank you so much for taking the time and effort to create a pull request to our Nextcloud project.

We hope that the review process is going smooth and is helpful for you. We want to ensure your pull request is reviewed to your satisfaction. If you have a moment, our community management team would very much appreciate your feedback on your experience with this PR review process.

Your feedback is valuable to us as we continuously strive to improve our community developer experience. Please take a moment to complete our short survey by clicking on the following link: https://cloud.nextcloud.com/apps/forms/s/i9Ago4EQRZ7TWxjfmeEpPkf6

Thank you for contributing to Nextcloud and we hope to hear from you soon!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants