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

Restructured files and contents for new MkDocs website #2968

Open
wants to merge 13 commits into
base: devel
Choose a base branch
from

Conversation

ashleynilo
Copy link
Collaborator

Related Issue(s) F Prime Website Refresh
Has Unit Tests (y/n) n
Documentation Included (y/n) n (documentation is in the internal JPL repo with custom pages)

Change Description

  • Major restructure of the website information architecture based on the diataxis method and to make room for new, informational pages on F Prime. The key categories now are
    • Home
    • Overview
    • Getting Started
    • Documentation
      • Tutorials
      • User Manual
      • How To
      • Reference
    • Support
    • Events
  • Added new markdown files that include a link to the custom HTML templates and a link to that page on the website for the user to view. Custom pages are not viewable via the public F Prime GitHub repository
  • Added new high-level overview pages for each documentation topic (Tutorials, User Manual, How To, and Reference)
  • Removed _data and _includes folders and the files inside them since MkDocs have its own built-in navigation and table of contents
  • Removed _config.yml since MkDocs has its own config file
  • Updated headings of ALL files so that there’s only one H1 as the title of the page, adjusting the remaining headings as needed so that headings aren’t skipped
  • Renamed some folders and pages to only use all lowercase and hyphens
    Updated links throughout all of the pages to match the new information architecture
  • Any Notes or sections with > have been converted to have Material for MkDocs Admonition/Callout styling. They now start with “!!! note” and are rendered normally when on the website.
  • Minor grammar/typo changes

Rationale

Refreshed the F Prime Website to use the MkDocs documentation framework with the Material for MkDocs theme. Along with the new framework the site will now be fully accessible via https://fprime.jpl.nasa.gov/. Many items in the fprime/docs folder have been restructured to fit the MkDocs framework and is also based on the diataxis method with research from the JPL Human Systems Integration group.

Testing/Review Recommendations

Major changes are mainly within the new structure of the files. Please check for any broken links or any content/files that may have been unintentionally removed or set to a certain heading hierarchy.

Future Work

None at the moment.

@thomas-bc thomas-bc mentioned this pull request Nov 7, 2024
10 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant