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

[animone]

I'd like to see a good document outlining the data flow through the entire DW system. Anything from what different sections of the DW code handle, to when/how a chunk of data is shipped off between servers/clusters. I can certainly see a use for this in the future, especially when designing and implementing new large features, as well as scaling decisions.

[kareila]

+1

[pauamma]

Apache::LiveJournal *whimper* *cringe*