The documentation, available in a Mac OS X version and Ubuntu version,
focuses on the easiest path to a working
OpenStreetMap database and TileMill project. (For Windows users the required tools are unfortunately a bit more complex to
install and set up; hopefully we’ll have some good documentation for you soon.)
OSM Bright goes great with Michal Migurski’s metro area extracts or
Geofabrik’s regional extracts of OpenStreetMap data. These are subsets of the full-planet
OpenStreetMap database that make it quicker and easier to set up a particular part of the map that you’re interested in.
As I discussed at last year’s State of the Map conference in Denver, the template has been designed
to be easy to customize, especially with regard to simple changes like the color palette which is defined in
one place at the beginning of the template. Further customizations can be made by digging deeper into the stylesheets,
which we’ve tried to organize sensibly. We’re actively working to improve OSM Bright, so if you notice issues feel free to file an issue on GitHub.