Here’s an article that talks about documenting open-source projects, like what is trying to happen at WordPress.