wikis4se-tutorial@wikisym2009

Tutorial on Agile Documentation with Wikis Ademar Aguiar INESC Porto, Departamento de Engenharia Informática Faculdade de Engenharia, Universidade do Porto ademar.aguiar@fe.up.pt ABSTRACT 2. LEARNING OUTCOMES Although some agile projects can succeed without producing any The tutorial aims at providing participants with the following documentation at all, others may require a little more. Best knowledge and capabilities: practices of agile documentation suggest producing just enough documentation, at just the right time, and for just the right  Principles and practices of agile documentation; audience. It is not by coincidence that wikis and agility share  Balancing documentation effort with effectiveness in goals of simplicity, flexibility, and open collaboration, thus being communication and understanding; natural documentation tools to agile projects. When well  Identifying tool requirements for agile documentation; integrated with other tools, wikis provide open collaboration, quick feedback, easy navigability, integrated contents, and a low  Fine-tuning wiki-based environments for agile barrier for developers to document. In this hands-on tutorial, documentation; participants will learn how to adapt and use a wiki to better  Integration of complimentary tools with the wiki; support software projects.  Features of wikis to consider for documentation purposes;  Wiki configuration (spaces, roles, templates, etc); Categories and Subject ...