adityavs / specifications

Specifications related to MongoDB

MongoDB Specifications

This repository holds in progress and completed specification for features of MongoDB, Drivers, and associated products. Also contained is a rudimentary system for producing these documents.

Writing Documents

Write documents using reStructuredText, following the MongoDB Documentation Style Guidelines.

Store all source documents in the source/ directory.

Building Documents

To build documents issue the make command in a local copy of this repository. The output PDFs end up in the build/ directory. The build depends on:

• Python Docutils
• A functioning basic LaTeX/TeX install with pdflatex. If you run OS X, use MacTeX

make all will build all documents in the source/ folder. The system builds all targets in build/.

Run make setup to generate (or regenerate) a makefile.generated file which provides specific targets for all files in the source file so you can choose to compile only some of the files that you need. Once generated, running "make [file-name-without-extension]" will rebuild only those files (if needed.)

Use make clean to remove the build/ directory and "make cleanup" to remove the LaTeX by-products from build/.

In the future...

• Templates will have logos, and templates for authorship, copyright, disclaimers, etc.
• Non-PDF output targets.

If you have specific feature requests, or need help getting things running, please contact [email protected].