I don't see a problem with images (as long we are not blowing up the repo size so much that github is becoming angry with us).

Committing the makefile is fine. If it is platform-independent it is definitely useful. If it isn't commiting it still won't hurt.

About docs/manuals: Well, I have rambled enough about how I feel about people calling tutorials manuals. I would really prefer if you would not do that. Both the locations psi29a and I have proposed would be okay.

I am now using Sphinx rather than a self-rolled makefile, that gives us more fancy output. Sphinx supports C and C++ as well, but it cannot grab the code documentation from the source files out of the box like Doxygen can (it can do that for Python though). If depending on Sphinx is not acceptable I can revert back to just reST, it's your decision.

Sorry for disappearing for almost a year, I have just updated the pending PR. I see someone else has been adding, what is the status of that? Is there a discussion thread going on? I couldn't find any.

If you mean on getting Sphinx set up on your computer, I'm currently writing a tutorial on how to set everything up to be able to help with documentation. I should have a bit of extra time over the next couple of weeks so I'm hoping to begin writing some more again.

@psi29a, I'm probably going to need some help figuring how to get everything set up on my computer myself so I can actually write the damn thing, so prepare yourself!