Comments and refactoring

addContent's make_content method is now
usable by other modules. This paves the
way for builder.py to use it to save
characters.

This commits also adds some more comments.