This allows the docs to be updated via pull requests and makes it easier to keep it in sync as a part of normal code updates.
Dave Collins