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

Diatixis Method Reorginization for Documentation #2717

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

Conversation

GavinKnudsen
Copy link

Related Issue(s) #2597
Has Unit Tests (y/n)
Documentation Included (y/n)

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:

Getting Started
    Installing F´

Tutorials
    HelloWorld
    LedBlinker
    MathComponent
    Cross-Compilation Setup Tutorial
    Arduino LedBlinker

User Guide
    F´ Users Manual
        A More Complete Introduction to F´
        Projects and Deployments
        Core Constructs: Ports, Components, and Topologies
        Data Types and Data Structures: Primitive Types, Enums, Arrays, and Serializables
        Data Constructs: Commands, Events, Channels, and Parameters
        Unit Testing F´ Components
    F´ Best Practices
        F´ Development Process
        Application, Manager, Driver Pattern
        Ground Interface
        Rate Groups and Timeliness
        Dynamic Memory and Buffer Management
        A Quick Look at the Hub Pattern
        Documenting F´ Projects
        Code and Style Guidelines
    F´ Ground Data System (GDS)
        A Brief Guide to the F´ Ground Data System
        The Discerning User’s Guide to the F´ GDS CLI
        The GDS Dashboard
        Sequencing in F´
        Installing F´ Console Autocomplete
    Full Development Guides
        Configuring F´
        F´ Modeling with FPP
        A Tour of the Source Tree
        F´ XML Specifications
        F´ Implementation Classes
        Constructing the F´ Topology
        Asserts in F´
        GDS Dashboard Reference
        Integration Test API
        CMake User Guide
    Advanced F´ Topics
        F´ Python Guidelines
        Porting F´ To a New Platform
        F´ On Baremetal and Multi-Core Systems
        Configuring an IDE for Use With F´
        OS Layer Description
        v3 Migration Guide
    Design and Philosophy
        F´ Software Architecture
        Numerical Types Design
        Communication Adapter Interface
        Package Implementations
        FPP JSON Dictionary Specification

How-To Guides
    F´ GDS Plugin Development
    F´ Library Development

Reference
    GDS CLI Design
    C++ Documentation
    CMake User API

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.

Copy link
Collaborator

@thomas-bc thomas-bc left a 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)

docs/_includes/toc.md Outdated Show resolved Hide resolved
docs/Reference/README.md Outdated Show resolved Hide resolved
docs/Reference/README.md Outdated Show resolved Hide resolved
docs/Design/general.md Outdated Show resolved Hide resolved
@GavinKnudsen
Copy link
Author

GavinKnudsen commented May 7, 2024

I deployed what I have so far to https://gavinknudsen.github.io/fprime/ I believe the corrections should be fixed now.

@thomas-bc
Copy link
Collaborator

Looks great!
A few notes, for discussion:

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.

None yet

2 participants