I'm always on the lookout for simplified project documentation [and/or templates]. I'm a big believer in ... "anything that will make my life simpler, just has to be good". I ran across this site StartUpCTO hosted by David Ordal. I've had a pretty good look [at least I think I have] for other, similar material, and there isn't a lot out there, at least not like this stuff. Have a squint and see what you think.
I was thrilled to find something that is targeting small teams and hobbyists - that is, those that bother with documentation. Note: The site doesn't specifically target hobbyists, I just added that in to serve my own needs. Hey, IMHO ... they should.
I like project documentation even for the piddly little "trivial" apps that I work with. When you've got more than one project that you're mulling over -or- have in development, it really helps to have a single central location for all those ideas you come up with when you're sitting in the "reading room", having a look at the paper and contemplating some snag that has you stumped.
I'm currently using MS OneNote 2003 to keep track of all these little bits-n-pieces and although it's the best tool I've come across [so far], it's still not the "right" tool for the job ... hopefully OneNote 2007 will be a better fit.
[rant] The Turbo series is targeting newbies, hobbyists and work alone/small team professionals [please, don't go there ... thanx]. With respect to the newbies and hobbyists ... other than spending a lot of time scratching their noggin and goofing off with nifty-cool IDE features where can they go for direction on how to get started ... properly? Nothing that I've seen, at the newbie level, even mentions how to properly get on the go with documenting a project. Just about every demo/tutorial you see is basically; "dive in, throw controls onto the form with abandon, double-click to get to the default methods and start rattling off some code". Yea, that's RAD ... do you really think these people don't want to do things right? Being one of them, I'd have to say ... yes, of course they do. Teach them how to do it right [or even that there is a right way], and they will. Sorry, bit of a sore spot it would seem :) [/rant]
If you have a process that you use when designing and implementing a small project, it sure would be nice [for the rest of us] if you would blog about it or publish it using some other means. I may do it myself someday, "winging it" hasn't [effectively] stopped me so far.
I'd appreciate any links to sites that you may know about that cover "lite" project documentation ... the ones that I may have missed.
Thanks for stopping by ... -- Dave
PS: First post to this site with Windows Live Writer - it's pretty cool, give it a spin. I picked it up from posts on the topic by Fernando Madruga and Steve Trefethen.
I also use OneNote 2003 as Idea/Documentation holder. Its a very and cool solution. I think this one is definetly very nice done. I hope the 2007 version uses an interface like Word 2007 ;) This interface is very great.
ReplyDeleteCheers, murphy