On 09/21/2011 12:00 PM, Andrea Crotti wrote:
I'm starting to work on a big documentation project of a huge python codebase.

I'm happy we chose sphinx+rst, I like it more and more, and we will probably use a lot from the autodoc extension.

I was wondering, is it possible to get somehow notified when a module/class which is used in the documentation changes?

Automatic documentation is great, but in case it changes it might start to contradict the documentation around, if there is a way to detect those changes it would be great...

Any ideas?
Thanks

Noone had my some idea?

I haven't investigated much yet, but I think that I could
- assign an ID to every fragment of code which is fetched using the autodoc extension (probably just the name would be perfectly enough)
- compute and store the checksum of that fragment somewhere

Next time sphinx runs checks if the checksum for the fragment is changed and eventually it prints a warning...

Would that make sense?

--
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to