-
Notifications
You must be signed in to change notification settings - Fork 1.3k
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
Diatixis Method Reorginization for Documentation #2717
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A few links need to be fixed and reformatted. Other than that, this looks good to me!
We have collaborators that are working on the design of the website currently, so I will ask them to weigh in here too.
FYI I have published your changes here: https://thomas-bc.github.io/fprime/ (which is how I realized the <h4>
discrepancy, see below)
I deployed what I have so far to https://gavinknudsen.github.io/fprime/ I believe the corrections should be fixed now. |
Looks great!
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@GavinKnudsen my sincere apologies for the time it took to get back to you.
We have been really busy recently and we also are in the process of reworking the website, so we had to be careful.
This is good work, thank you very much!
Change Description
Regrouped the TOC. Added Pages for Getting Started and Reference index pages. Changed current index page for User Guide to reflect the regrouping. Fixed the HowTo link on the TOC to point to the right page. Removed the Design and Philosophy index page as it was regrouped into the Users Guide.
This is the new reorganized TOC:
Rationale
A rationale for this change. e.g. fixes bug, or most projects need XYZ feature.
Testing/Review Recommendations
Let me know what you think about this organization of the TOC and if I updated the documentation appropriately.
Future Work
Adding more to the Getting Started section to help orient new users.