More or less concrete ideas of material that could go into the book

  • quick start section similar to the one on fossil's homepage, just a bit more verbose with explanations and links to relevant sections where the actions are explained in more detail
  • explanation why fossil is called fossil (from Quotes: "The very name 'fossil' was to chosen to reflect the unchanging nature of things ..."*.)
  • section on markup: fossil wiki markup, markdown, plain text (here also mention commands such as fossil test-markdown)
  • section on pikchr
  • section on skins and the UI CSS
  • include explanations from interesting/important forum posts or from post with often asked questions
  • comparison with git
  • section on the philosophy of fossil and the fundamental design principles
  • section on what kind of animals artifacts are
  • section on libfossil
  • section on the cvs2fossil script and to importing from other systems
  • note when a certain feature was added? (such as "the --numstat option to the fossil diff command was added in fossil 2.3")

Ideas on the structure

  • key word and command index (as in the current version)
  • boxes with „Good to know“ hints
  • boxes with „Best practice“
  • admonitions for small hints, warnings, „see also …“ and others

Ideas on the layout

  • coloured background for CLI text and code
  • nice image and/or citation at start of chapter (see Quotes)
  • coloured text for certain types of content?
  • for HTML version: good navigation on every page!