Diatixis Method Reorginization for Documentation

docs/GettingStarted/README.md

@@ -0,0 +1,9 @@
+---
+layout: default
+title: "Getting Started with F'"
+---
+
+These resources will walk a new user from a basic getting-started guide for successful use of F'. This includes an introduction to F', installation instructions, and information about how this documentation is structured. This will help new users to learn F´ and walk through the most basic steps in developing an F´ application.
+
+## Getting Started Guide
+1. [Installing F´](./fprime/INSTALL.html): F´ and Embedded Hardware 

docs/Reference/README.md

@@ -0,0 +1,11 @@
+---
+layout: default
+title: "Reference"
+---
+
+These resources act as references that provide technical descriptions of F'. You will find API documentation here.
+
+## API Documentation
+1. [GDS CLI Design](./fprime/UsersGuide/dev/gds-cli-dev.html)
+2. [C++ Documentation](./fprime/UsersGuide/api/c++/html/index.html)
+3. [CMake User API](./fprime/UsersGuide/cmake/cmake-api.html)

docs/UsersGuide/guide.md

@@ -5,16 +5,11 @@ goal is simple: make the development of flight-quality embedded software simple,
 and overhead to develop such systems.
 
 This guide is intended to expose the features of F´ and seek to allow users and developers to take advantage of all F´
-has to offer. It is broken down into five documentation sections:
-- Getting Started
+has to offer. It is broken down into three documentation sections:
 - User's Manual 
 - Best Practices
 - Developer Documentation
-- API
 
-**The Getting Started** section points initiates to all the items needed to get up and running with F´. Since these are
-often needed before a user searches for a user's guide, this section merely links to the stand-alone version of those
-items.
 
 **The User's Manual** section helps users of this framework understand the concepts of F´ and build more complex projects
 using the Framework. It is where users should go to understand more about what is possible in F´.
@@ -26,23 +21,18 @@ techniques.
 **The Developer Documentation** is intended for developers who want to use some of the advanced features of F´, understand
 how the framework is organized internally, and otherwise dig deep into F´ concepts and implementation. Anyone who wishes
 to extend or change F´ should consult this section.
-This section is divided into three sub-sections:
+This section is divided into four sub-sections:
 - Ground Data System Tools (GDS)
 - Full Development Guides: technical details for full F´ implementations
 - Advanced F´ Topics
+- Design and Philosophy
 
 
-**The API documentation** section contains the automatically generated documentation on F´.
 
 **Note:** currently this documentation is being assembled. Please feel free to contribute!
 
 ## Table of Contents
 
-- Getting Started with F´
-    - [What is F´: a brief introduction](../index.md)
-    - [Installing F´](../INSTALL.md)
-    - [Installing F´ Console Autocomplete](./user/autocomplete.md)
-    - [Tutorials: A Hands On Guide to F´](../Tutorials/README.md)
 - F´ Users Manual: an in-depth description of F´ concepts
     - [A More Complete Introduction to F´](user/full-intro.md)
     - [Projects and Deployments](user/proj-dep.md)
@@ -82,11 +72,12 @@ This section is divided into three sub-sections:
     - [Configuring an IDE for Use With F´](./dev/configure-ide.md)
     - [OS Layer Description](./dev/os-docs.md)
     - [v3 Migration Guide](./user/v3-migration-guide.md)
-- API Documentation
-    - [GDS CLI Design](./dev/gds-cli-dev.md)
-    - [C++ Documentation](./api/c++/html/index.html)
-    - [CMake User API](./cmake/cmake-api.md)
-
+- Design and Philosophy
+    - [Software Architecture](./fprime/Design/fprime-architecture.html)
+    - [Numerical Types Design](./fprime/Design/numerical-types.html)
+    - [Communication Adapter Interface](./fprime/Design/communication-adapter-interface.html)
+    - [Package Implementations](./fprime/Design/package-implementations.html)
+    - [FPP JSON Dictionary Specification](./fprime/Design/fpp-json-dict.html)
 
 
 ## F´ Source Tree F´ Out of the Box Items

docs/_includes/toc.md

@@ -1,6 +1,6 @@
-<h4><a href="/fprime/INSTALL.html">Getting Started</a></h4>
+<h4><a href="/fprime/GettingStarted/README.html">Getting Started</a></h4>
   <ul>
-    <!-- empty list for consistent spacing between items -->
+    <li><a href="/fprime/INSTALL.html">Installing F´</a></li>
   </ul>
 <h4><a href="/fprime/Tutorials/README.html">Tutorials</a></h4>
   <ul>
@@ -12,15 +12,6 @@
   </ul>
 <h4><a href="/fprime/UsersGuide/guide.html">User Guide</a></h4>
   <ul>
-    <details>
-      <summary>Getting Started with F´</summary>
-      <ul>
-        <li><a href="/fprime/">What is F´: a brief introduction</a></li>
-        <li><a href="/fprime/INSTALL.html">Installing F´</a></li>
-        <li><a href="/fprime/UsersGuide/user/autocomplete.html">Installing F´ Console Autocomplete</a></li>
-        <li><a href="/fprime/Tutorials/README.html">Tutorials: A Hands On Guide to F´</a></li>
-      </ul>
-    </details>
     <details>
       <summary>F´ Users Manual</summary>
       <ul>
@@ -55,6 +46,7 @@
         <li><a href="/fprime/UsersGuide/gds/gds-cli.html">The Discerning User’s Guide to the F´ GDS CLI</a></li>
         <li><a href="/fprime/UsersGuide/gds/gds-custom-dashboards.html">The GDS Dashboard</a></li>
         <li><a href="/fprime/UsersGuide/gds/seqgen.html">Sequencing in F´</a></li>
+        <li><a href="/fprime/UsersGuide/user/autocomplete.html">Installing F´ Console Autocomplete</a></li>
       </ul>
     </details>
     <details>
@@ -84,24 +76,24 @@
       </ul>
     </details>
     <details>
-      <summary>API Documentation</summary>
+      <summary>Design and Philosophy</summary>
       <ul>
-        <li><a href="/fprime/UsersGuide/dev/gds-cli-dev.html">GDS CLI Design</a></li>
-        <li><a href="/fprime/UsersGuide/api/c++/html/index.html">C++ Documentation</a></li>
-        <li><a href="/fprime/UsersGuide/cmake/cmake-api.html">CMake User API</a></li>
+        <li><a href="/fprime/Design/fprime-architecture.html">F´ Software Architecture</a></li>
+        <li><a href="/fprime/Design/numerical-types.html">Numerical Types Design</a></li>
+        <li><a href="/fprime/Design/communication-adapter-interface.html">Communication Adapter Interface</a></li>          <li><a href="/fprime/Design/package-implementations.html">Package Implementations</a></li>
+        <li><a href="/fprime/Design/fpp-json-dict.html">FPP JSON Dictionary Specification</a></li>
       </ul>
     </details>
   </ul>
-<h4><a href="/fprime/Design/general.html">Design and Philosophy</a></h4>
-  <ul>
-    <li><a href="/fprime/Design/fprime-architecture.html">F´ Software Architecture</a></li>
-    <li><a href="/fprime/Design/numerical-types.html">Numerical Types Design</a></li>
-    <li><a href="/fprime/Design/communication-adapter-interface.html">Communication Adapter Interface</a></li>
-    <li><a href="/fprime/Design/package-implementations.html">Package Implementations</a></li>
-    <li><a href="/fprime/Design/fpp-json-dict.html">FPP JSON Dictionary Specification</a></li>
-  </ul>
-<h4><a href="/fprime/Design/general.html">How-To Guides</a></h4>
+<h4><a href="/fprime/HowTo/general.html">How-To Guides</a></h4>
   <ul>
     <li><a href="/fprime/HowTo/develop-gds-plugins.html">F´ GDS Plugin Development</a></li>
     <li><a href="/fprime/HowTo/develop-fprime-libraries.html">F´ Library Development</a></li>
   </ul>
+<h4><a href="/fprime/Reference/README.html">Reference</a>      
+  <ul>
+    <li><a href="/fprime/UsersGuide/dev/gds-cli-dev.html">GDS CLI Design</a></li>
+    <li><a href="/fprime/UsersGuide/api/c++/html/index.html">C++ Documentation</a></li>
+    <li><a href="/fprime/UsersGuide/cmake/cmake-api.html">CMake User API</a></li>
+  </ul>
+</h4>