Updates and removal of chapter and appendix wording

Author: kaosine

outline.md

@@ -1,19 +1,21 @@
 # Outline for Pulsar documentation
 
-This uses the og atom Flight manual as a base, and converts and refactors it for modern standards. This will be converted to and tracked from our projects using seperate ones for each section.
+This uses the original material from the Atom Flight manual(their documentation) as a base, and converts and refactors it for modern standards. This will be converted to and tracked from our projects using seperate ones for each section. It is fully expected that all text from your sections has been ran through a tool like [Language Tool](https://languagetool.org). All material should be free from as many errors as possible. We would like to eventually add support for other languages using a language translation service. That way we aren't alienating our userbases from other parts of the world.
 
 ## Old Already "Finished" sections
 
-These are alredy in our atom-archive folder. These just need to be reformatted, branding changed, and use ours and more modern standards. Especially since as we move to more updated libraries methods mentioned in these sections will change and/or break.
+These are already in our atom-archive folder. These just need to be reformatted, branding changed, and use ours and more modern standards. Especially since as we move to more updated libraries methods mentioned in these sections will change and/or break.
 
-### Chapter 1: Getting Started
+### Launch Manual
+
+#### Getting Started
 
 - Why Atom?
 - Installing Atom
 - Atom Basics
 - Summary
 
-### Chapter 2: Using Atom
+#### Using Atom
 
 - Atom Packages
 - Moving in Atom
@@ -32,7 +34,7 @@ These are alredy in our atom-archive folder. These just need to be reformatted,
 - Basic Customization
 - Summary
 
-### Chapter 3: Hacking Atom
+#### Hacking Atom
 
 - Tools of the Trade
 - The Init File
@@ -55,7 +57,7 @@ These are alredy in our atom-archive folder. These just need to be reformatted,
 - Maintaining a Fork of a Core Package in atom/atom
 - Summary
 
-### Chapter 4: Behind Atom
+### Advanced topics
 
 - Configuration API
 - Keymaps In-Depth
@@ -67,67 +69,13 @@ These are alredy in our atom-archive folder. These just need to be reformatted,
 - How Atom Uses Chromium Snapshots
 - Summary
 
-### Reference: API
-
-**_this section is not loaded in since it's in JSON files we need to parse._**
-
-- AtomEnvironment
-- BufferedNodeProcess
-- BufferedProcess
-- Clipboard
-- Color
-- CommandRegistry
-- CompositeDisposable
-- Config
-- ContextMenuManager
-- Cursor
-- Decoration
-- DeserializerManager
-- Directory
-- DisplayMarker
-- DisplayMarkerLayer
-- Disposable
-- Dock
-- Emitter
-- File
-- GitRepository
-- Grammar
-- GrammarRegistry
-- Gutter
-- HistoryManager
-- KeymapManager
-- LayerDecoration
-- MarkerLayer
-- MenuManager
-- Notification
-- NotificationManager
-- Package
-- PackageManager
-- Pane
-- Panel
-- PathWatcher
-- Point
-- Project
-- Range
-- ScopeDescriptor
-- Selection
-- StyleManager
-- Task
-- TextBuffer
-- TextEditor
-- ThemeManager
-- TooltipManager
-- ViewRegistry
-- Workspace
-- WorkspaceCenter
-
-### Appendix A: Resources
+### Resources
 
 #### Glossary
 
 - This section may be done already in the old one, but may need updating.
 
-### Appendix B: FAQ
+### FAQ
 
 - Is Atom open source?
 - What does Atom cost?
@@ -176,7 +124,7 @@ These are alredy in our atom-archive folder. These just need to be reformatted,
 
 ## The remaining bits to be written and finished:
 
-### Chapter 3: Hacking Atom
+### Hacking Atom
 
 - Tutorials:
   - Word Count Package (Basic)
@@ -203,7 +151,7 @@ These are alredy in our atom-archive folder. These just need to be reformatted,
     - Shadow DOM
     - https://atom.io/docs/latest/upgrading/upgrading-your-ui-theme
 
-## Chapter 4: Behind Atom
+### Advanced Hacking
 
 - advanced dev tools
   - keybinding resolver
@@ -218,8 +166,9 @@ These are alredy in our atom-archive folder. These just need to be reformatted,
   - view best practices
   - don't make a slow package
   - CI for packages (https://blog.atom.io/2014/04/25/ci-for-your-packages.html)
+- Reference Manual
 
-### Include in Chapter 3 or 4
+### Include in Core Hacking or Behind Pulsar
 
 - Make sure we include (in Ch 3 or Ch4 or both)
   - scopes (https://atom.io/docs/v0.174.0/advanced/scopes-and-scope-descriptors)
@@ -252,7 +201,7 @@ These are alredy in our atom-archive folder. These just need to be reformatted,
   - modal decorations
   - notifications
 
-## Chapter 5: Contributing to Atom
+### Contributing to Atom
 
 - To packages:
   - Cloning and apm linking
@@ -278,15 +227,89 @@ These are alredy in our atom-archive folder. These just need to be reformatted,
   - Coding conventions
   - Commit conventions
 
-## ~Chapter 6: Electron~
+### Further
 
-This section is probably going to be relegated to not being implemented. We have no control over electron and the best we can do is point people to their website elsewhere.
+- Cookbook snippets <- this should be moved and put elsewhere.
+  - As in this Is probably more tutorial related if we want to make a section based on tutorials and move them all there.
 
-- ~developing a new project in electron~
-- ~https://github.com/atom/electron~
+### API Manual
 
-## Chapter 7 / Appendix
+#### Client API
 
-- Reference Manual
-- Cookbook snippets <- this should be moved and put elsewhere.
-  - As in this Is probably more tutorial related if we want to make a section based on tutorials and move them all there.
+**_this section is not loaded in since it's in JSON files we need to parse._**
+
+<!-- This section needs to be organized by purpose, if I'm looking for I/O, file management where would I go for that? I'm including some sections for this that we can decide upon which to add, and where to put what already exists -->
+
+- File Management
+- I/O
+- Styling
+
+<!-- These have not been categorized into any section above and need to be moved -->
+
+- AtomEnvironment
+- BufferedNodeProcess
+- BufferedProcess
+- Clipboard
+- Color
+- CommandRegistry
+- CompositeDisposable
+- Config
+- ContextMenuManager
+- Cursor
+- Decoration
+- DeserializerManager
+- Directory
+- DisplayMarker
+- DisplayMarkerLayer
+- Disposable
+- Dock
+- Emitter
+- File
+- GitRepository
+- Grammar
+- GrammarRegistry
+- Gutter
+- HistoryManager
+- KeymapManager
+- LayerDecoration
+- MarkerLayer
+- MenuManager
+- Notification
+- NotificationManager
+- Package
+- PackageManager
+- Pane
+- Panel
+- PathWatcher
+- Point
+- Project
+- Range
+- ScopeDescriptor
+- Selection
+- StyleManager
+- Task
+- TextBuffer
+- TextEditor
+- ThemeManager
+- TooltipManager
+- ViewRegistry
+- Workspace
+- WorkspaceCenter
+
+#### Package Server API
+
+<!-- TODO -->
+
+#### Other API
+
+<!-- TODO This needs to figured out what others we need here -->
+
+### Atom archive
+
+The "chapters" from the orignal, this section is done. It only serves as a
+reference guide to make copies of in it's new home and then `rebrand -> update -> reorganize` we fully expect that these files are now at a state where we can
+leave them alone in this folder. However We do expect that you pull from here
+and update things if we do not already have it updated ourselves. It should be
+easier to pull from here instead of writing from scratch. If need be put
+warnings ala our common text blocks in the sections, warning that these are
+under active development to fit things.