call for doc requests

[mark]

Hey --

I realize that there's a lot of things that would be useful to disseminate. Stuff about the way the code works, some conventions, why things are the way they are, and more advanced topics like database handles and stuff like that. I'd love to get some requests -- see what people are really the most curious about, so I can prioritize writing the docs. But here are some things I've thought of:

* What is a database master, slave, when should I call "get_db_writer" versus "get_db_reader" and what is this "get_cluster_def_reader" thing anyway?

* What are database clusters, what is the global database, what goes where?

* What is TheSchwartz/Gearman, how do I use it, when should I?

* What should be stored in memcache, what are the best practices?

* ...

Crap, I had a bunch more when I was thinking about this before bed last night. Should have written them down then... oh well. Is there anything you are curious about that you think might make a good bit of documentation?

Comments

[liv]

Documenting the styles system is kind of separate. The styles people are working on it, we know it urgently needs doing... Have a poke around the Wiki, there are pages there like http://wiki.dwscoalition.org/notes/S2_functions and http://wiki.dwscoalition.org/wiki/index.php?title=Category:S2_Properties which represent early stages in the genesis of styles documentation.