I have been documenting using restructuredtext and sphinx. I am still learning but I think it is coming together.