compass/doc-src
2010-01-24 16:11:00 -08:00
..
.compass Hover tooltips for colors. 2010-01-24 01:34:05 -08:00
content documentation for the blueprint grid. 2010-01-24 16:10:29 -08:00
layouts Breadcrumb trails. 2010-01-24 16:06:34 -08:00
lib Some cleanup and debug code removal. 2010-01-24 16:07:13 -08:00
config.yaml Initial doc site with nanoc. 2010-01-20 22:25:59 -08:00
Gemfile rdiscount dependency. 2010-01-24 02:01:05 -08:00
Rakefile A rake task to turn normal files into nanoc items. 2010-01-23 01:05:24 -08:00
README.markdown document the documentation. 2010-01-24 16:11:00 -08:00
Rules Hover tooltips for colors. 2010-01-24 01:34:05 -08:00

Documentation README

This is the documentation for Compass. Much of the documentation is read from the sass source files to keep the docs in-line with current state of the code as much as possible.

If you're reading this, you might be thinking about helping to improve the compass documentation by editing existing documentation or by adding new documentation.

There are two main kinds of documentation:

  • Tutorials: Describe HOW to use compass.
  • Reference: Details about WHAT compass has.

It's possible and encouraged for related tutorials and reference documentation to link to each other.

Getting Around the Documentation Project

  • .compass/config.rb - This is where the compass configuration is kept.
  • content/ - This directory is where content for the documentation project is kept.
  • content/reference - This is where reference documentation is kept.
  • content/tutorials - This is where tutorial documentation is kept.
  • content/css - Third-party, plain old CSS files.
  • content/images - Images. Duh.
  • content/javascripts - Javascripts. Double Duh.
  • content/stylesheets - Sass stylesheets for the project.
  • layouts - Layouts are kept here.
  • layouts/partials - Partials are kept here.
  • lib - Ruby code. Helper code and sass source inspection is done here.