Tidying up the existing doco is a big job (often as big or bigger than the task of nameing it), but when done right, it's a really good thing. I usually do a cleanup binge whenever I see something that's getting messy, so I encourage others to do likewise... and of course no changes are final on a wiki, so if you make a mistake, then it can always be fixed ;) Go for it! I like the idea of a single page which covers the three (and more) PICs which can be used. Not sure how much detail can go into it, but it's a good idea. Tips: Remove everything that's duplicated or outdated. If you remove outdated stuff, replace it with new info, and put a pointer to the old info there, so that if people find old info, they'll know to ignore it when they read your page. Follow backlinks when you remove a page, so that you can update links to your replacement doco. Search the forum for corroborating info. You don't wanna put the wrong info on there and get egg on your face when someone screws up because of your words :) Search for similar pages to the one you're working on, and follow links from it. If you find one little bit of mess, chances are there are related messes that should be cleaned at the same time. OK You've opened a can of worms..... There are no new platform docs as such, just the /doc/MEMO file on SVN to get the devs started up. However, if you're thinking of doing a *really* big tidy-up, then perhaps it should be considered to start arranging the files in a manner which 'makes room' for the new stuff when it's time to put it up there... Ther are other things which could do with some attention, from memory: Like our three FAQs ;D something needs to be done there... and the blurred division between 'end-user' and 'developer' targeted doco should be removed too IMO.... Unless you're building a TK-clone or a wilbasid, "development" - to some degree, if only something minor like changing the number of pots in your controler, is unavoidable. In general, I think that the doco could do with a more linear structure. The #1 request for doco, by country mile, is a "start to end" tutorial on building "something". Of course, there are large amounts of duplicated documentations involved in doco like that - for example you don't need to explain how to build a core for a clockbox *and* a MBCV - it's the same thing. If you view it from a distance, the beginning and end of the wiki should be the same for all projects: Beginning: Welcome to MIDIbox.org! End: Enjoy your song! Everything inbetween, can fit into a sort of cigar-shaped structure, where topics branch out for specifics, and then re-merge where the split topics are no longer necessary. I toyed with some layouts like this in visio flowcharts and it was looking pretty good, but it's a big ass job, so I've been sitting on the idea until the new platform doco is ready. Seems like an opportunity to bounce the ideas off you guys ;)