I’ve spent the last two weeks in work doing documentation. I’m useless at it! I can visualise the program flow, but when it comes to breaking it down to actually draw out the state diagram, I get bogged down in implementation issues. Granted, this documentation is design documentation, rather than user documentation, so the implementation issues haven’t yet been ironed out. But it’s still a pain to write.
I’m also on the other side though. I’m messing around with FUSE, and its documentation sucks! Actually, there’s no decent documentation on the functions available, apart from comments in the header files. Even the usual Google search for documentation or a howto shows up nothing really useful.
Hopefully, when (if!) I make sense of it, and come out with something useful, I’ll be able to document the process. Of course, it’s documentation, and I’m a coder, so it’ll probably never get done!!
