the developer documentation should live with the source code, otherwise it will go stale over time. That makes it easier to maintain.