What are best practices for documation in a web development project?

I have hired a web development team to build a dynamic website which will be the core platform for a business I am starting. I got strong advice to make sure that they keep good documentation, so I am not held hostage by their understanding of the code as our organization grows. I have asked them what documentation they do, and they showed me mild descriptions they write before different bits of code, written into the source. I doubt this is good enough and I need a standard for documentation, so I can turn to them and say “make sure you do it like this”. They are programming using the Ruby on Rails development environment.

Leave a Reply