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

PD-379: Docs Hub section pages (home, indexes) review #1916

Merged
merged 26 commits into from
May 24, 2023

Conversation

Mrt134
Copy link
Collaborator

@Mrt134 Mrt134 commented May 22, 2023

This is a large PR that reviews all the index files contained in the Docs Hub file structure and makes these general updates:

  • Add any missing "description" front matter.
  • Make children shortcode display article descriptions.
  • Fix any errors in displaying article descriptions and syntax.
  • Remove empty directories or directories that have a single content file.

A large number of files are being changed, although the specific changes to each file are minimal. My recommendation for review is to pull this branch and locally build test.

Thanks for contributing to TrueNAS documentation! By opening a Pull Request, you're acknowledging that your changes will be distributed under the Creative Commons 4.0 license.

Mrt134 added 17 commits May 2, 2023 14:00
- Fix descriptions that weren't properly displaying.
- Pare down some section content lists when there are to0 many child articles.
- Remove off-brand images in section index files (to be replaced with TrueNAS-branding related imagery)
- remove additional navigation instructions as too many pointers were becoming confusing.
- Clean up some directories that had a single file (with aliases added for removed URLs).
- Add missing description front matter
- Fix up some directories with a single file.
- Replace Article Summaries with Contents
- generally standardize how _index files present information and child articles.
- Add missing descriptions
- Remove single file directories (and alias the content file)
- Standardize the Contents sections and children article display.
@Mrt134 Mrt134 marked this pull request as ready for review May 23, 2023 15:44
@Mrt134 Mrt134 requested a review from a team as a code owner May 23, 2023 15:44
@micjohnson777 micjohnson777 added the Technical Writer Review (MJ) A technical writer is reviewing the PR. label May 24, 2023
@micjohnson777 micjohnson777 merged commit 8a6bd89 into master May 24, 2023
3 checks passed
@micjohnson777 micjohnson777 deleted the PD-293_sectionpagesrefresh branch May 24, 2023 12:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Technical Writer Review (MJ) A technical writer is reviewing the PR.
Projects
None yet
3 participants