Practical Factor

I have been familiarizing myself with the Factor documentation system. I am working on a documentation outline for a new document called "Practical Factor". The Practical Factor documentation will incorporate and replace the current cookbook and serve as a starting point for new programmers.

The idea behind Practical Factor is to provide an entry point into the Factor programming language, starting at the fundamentals and then gradually progressing to more advanced topics. The content in Parctical Factor will also be cross-linked with the existing documentation.

The following is the outline I am working on. Any comments are welcome. Please note that this is the 1st draft and that it is still incomplete.

o) Introduction to Factor
  -> History
  -> Factor Highlights
  -> Factor Online
  -> Conclusion

o) Factor Basics
  -> Code Comments
  -> Fundamental Data Types and Literals
    -> Integers
    -> Rationals
    -> Floating-Point Numbers
    -> Ratios
    -> Complex Numbers
    -> Characters and Strings
    -> Booleans
  -> Variables, Constants, and the Stack
    -> Variables
    -> Constants
    -> Introducing the Stack
    -> Namespaces
  -> Words
    -> Introducing Words
    -> Shuffle Words
    -> Generic words and Methods
  -> Using Vocabularies
  -> Your First Factor Program

o) Conventions
  -> Documentation Conventions
  -> Vocabulary Naming Conventions
  -> Word Naming Conventions
  -> Stack Effect Conventions

o) Collections
  -> Sequence Operations
  -> Arrays
  -> Vectors
  -> Bit Arrays
  -> Byte Arrays
  -> Float Arrays
  -> String Buffers
  -> Hashtables
  -> Association Lists
  -> Queues

o) Quotations

o) Objects
  -> Equality and Comparison
  -> Classes
  -> Tuples
  -> Mirrors

o) Control Flow
  -> Conditionals and Logic
  -> Combinators
  -> Continuations
  -> Closures
  -> Currying

o) I/O Operations
  -> Working with Files
  -> Networking
  -> Streams
  -> Binary Data
  -> Processes
  -> I/O Timeout Protocol

o) Factor Philosophy and Pitfalls

o) Writing and Distributing Factor Applications
  -> Program Organization
    -> Definitions
    -> The Parser
    -> Vocabularies
    -> Vocabulary Loader
  -> Writing Unit Tests
  -> Factor Scripting
  -> Deploying Your Factor Application

o) Concurrency

o) Foreign Function Interface

o) Factor Internals and Implementation
  -> Non-Optimizing Compiler
  -> Optimizing Compiler
  -> Stack Effect Inference
  -> Memory Management (Garbage Collection)
  -> Factor Help System

o) UNSORTED TOPICS
  -> Parser Algorithm
  -> Parse Time Evaluation