Skip to content
This repository has been archived by the owner on Dec 15, 2022. It is now read-only.

Latest commit

 

History

History
122 lines (109 loc) · 3.82 KB

outline.md

File metadata and controls

122 lines (109 loc) · 3.82 KB

This is the sort of planning document and outline for the Atom book. This largely outlines how we're composing the book and what is still to be done. We'll remove lines from this when each section is completed so we only have what it left to do here.

You'll notice in some of the active book/[section]/sections/ folders there are some xx-name.asciidoc files. These are sections of content that should probably be folded in at some point but we're not sure exactly where to put them. They aren't included in any of the main files, so they aren't currently rendered. If you want to write something and aren't sure where it goes, you can name the file in this manner until we figure out how to fold it into the narrative structure.

Here is the remaining outline:

Chapter 3: Hacking Atom

  • Tutorials
    • Word Count Package (Basic)
    • Word Count Status Bar (status bar manipulation)
    • Go To Line Package (simple with feedback and cursor movement)
    • Open On GitHub - (no UI, just run command)
    • Snippets - (modify text in a buffer)
    • Linter - (modify text in a buffer, shell to external command)
    • Preview Pane (add a panel)
    • Fuzzy Finder (modal and open file in new tab)
    • Tree View / Mini-map (add a sidebar panel)
    • Status Bar (add small panel)
    • Git-Log / Settings View (standalone UI in tab)
    • Git-status / Bookmarks (decorate gutter)
    • Autocomplete / Color picker (in-context UI)
    • Vim-mode (editor remapping)
    • Image View (file type rendering handler)
    • Language (GFM?)
      • Creating grammars
      • converting-a-text-mate-bundle.md
    • Unity UI (UI theme)
      • converting-a-text-mate-theme.md
      • theme-variables.md
      • Shadow DOM

Chapter 4: Behind Atom

  • advanced dev tools
    • keybinding resolver
    • timecop
  • Maintaining Packages
    • how to publish
      • Atom.io package system (adding, searching, stars)
    • changelog
    • issue tracker
  • Best practices (patterns and anti-patterns)

Include in Chapter 3 or 4

Chapter 5: Contributing to Atom

  • To packages
    • Cloning and apm linking
    • apm install/update
    • Native modules
    • Running specs
    • Link to sending a pull request
  • To core

Chapter 6: Electron

Chapter 7 / Appendix

  • Reference Manual
  • Cookbook snippets