Business rule documentation embedding in report

When I first started working on Cognos the first task assigned to me was to prepare report specification document. This document gives an idea about the design of a report as well as business rules implemented in the Report. It took me around 3 Days to deliver that document.
We then had a brain storming session where we discussed how we make documentation process simpler.
As a team (Cognos pool) we came up with certain points and finally decided to create one documentation page in the report itself.
This documentation page should not visible to users and developers only would have access to it.
The separate report page mentions all the business rules as well as additional information about the objects in report.
Ram created template which contains one documentation page. Now whenever we start building a new report we use the same template.
Embedding the documentation in application made our documentation simpler. It has worked for us. Do you think it can work for you??