Employing a wiki to add product information is a quick an easy way to allow each stakeholder to work on presenting information that is relevant for customers and users. Customer facing information is required to follow the principle of least astonishment. That is a customer needs to find the required information quickly and in an expected format. This expected format allows the customer to find the relevant information quickly in a page. For open source software products, especially plugins for Maven, the Maven Site Plugin provided a way to generate a product site based on information checked in with the source code. The result is that those pages share a common navigation structure. This helps users of plugins for Maven to find information quickly despite the fact that the creators of plugins are working for different organisations or do many of their work in their spare time. Th PDAC1 provides doctypes to support a common structure for open source projects. projectdoc for Maven Developers create pages for plugins by reading information from the POM and plugin descriptor. projectdoc for Java Developers also reads information from a POM to create spaces to document libraries for Java. The Doctypes for App Manuals provide doctypes to document apps for Confluence or projectdoc. |