Wow, this is amazing, janra! you've already included a lot of the stuff that i would have suggested (like explaining the possibilities of boxes and special pages.)
I can see it isn't finished, but I'll just add some random ideas from problems I had installing/configuring, besides what we've already discussed in this thread. Again, I've only worked with scoop 0.8 - so some of my comments may be irrelevant to 0.9, but:
- site_controls: In general, I wished there had been more extensive documentation in the previous admin guide for each site_control. But, to single out the ones I had the most trouble with:
1) mojo and supermojo could be explained in more depth and detail (I'm still kinda fuzzy on how mojo works in general, actually.)
2) auto_post - that one's still a mystery to me - if I try to use it, the voting mechanisms become mysterious to me, so I don't use it. :-)
3) How to use rdf feeds (both to syndicate one and to pull in other sites.) I'm an RDF/RSS newbie, and I couldn't figure it out from what was in the docs. On the other hand, one of our developers who is actually familiar with RDF/RSS has been trying to figure it out, and he has so far had no luck either.
- Could be useful to have some links between boxes and blocks in "where do I start" and in "admin tools"? Each of our developers initially asked the question "what's the difference between a box and a block?"
- Also, a "hacking scoop" section could be useful... when we were adding things, I found some docs on it that were useful.. at the moment I only am finding the admin guide docs, but I could have sworn I found a thread in the past here on scoop.kuro5hin that explained more about how new things have to get added in to apachehandler, etc...
But maybe that could be part of a section on expansion in general - a very basic thing that wasn't obvious to us at first was how to add things to existing functions - for example, I didn't realize at first it was possible to add new special pages. In the "expansion" section could be hacking scoop, your SBE section, adding special pages, site_vars, blocks, etc... I see you already have an "expandable functionality" section, but I'd integrate all those things together (SBE, etc.) Another thing that our developers each pondered was the question: how do I know if something I need to change is handled in the database (web-controlled stuff) or the code? The answer we came up with was "grep through the code for the string you're looking for - if it isn't there, it must be in the database." Is there a better answer to that?
- And, maybe a FAQ type thing too? (for questions like "what's the difference between a box and a block?"
Those are the ones off the top of my head... plus what you have seen in my other notes already... would be most useful of course to get feedback from people who are installing for the first time right now... anyway, looks like it's coming along really well!
