- Foundation for Open Project Documentation
The Foundation for Open Project Documentation [Shalyto A. [http://www.codeproject.com/gen/design/nifopd.asp Foundation for Open Project Documentation at Code Project] ] is an organization. Its main idea is to create detailed and public documentation for all stages of software creation. The foundation was established in
2002 on the grand opening of the semifinals ofACM International Collegiate Programming Contest inSaint Petersburg byAnatoly Shalyto . This foundation was announced on theLinux Summit 2004 [ [http://is.ifmo.ru/foundation/linux/ Part of the program of Linux Summit 2004] ] [Shalyto A. Naumov L. Foundation for Open Project Documentation. [http://is.ifmo.ru/foundation_en/_Presentation.en.ppt Presentation for Linux Summit 2004] ] , Russian Outsourcing and Software Summit 2004 [ [http://www.soft-outsourcing.com/upload/ross2004.pdf Fourth Russian Outsourcing and Software Summit] ] and Open Source Forum Russia 2005 [ [http://is.ifmo.ru/science/opensource/ Photos from Open Source Forum Rissua 2005] ] . Project documentation development approbation in the context of this foundation was made in projects created usingSwitch-technology , intended for supportingAutomata-Based Programming [ [http://is.ifmo.ru/projects_en/ Projects, created using Switch technology with open project documentation.] ] [ [http://is.ifmo.ru/unimod-projects-en/ Projects, created using UniMod tool with open project documentation.] ] .[
Anatoly Shalyto onLinux Summit 2004, Helsinki ]Motivation
The motivation for creating "detailed" documentation is considered the following:
* software quality increases
* program verification simplifies
* project modification becomes easier and saferThe motivation for making documentation "open" is considered the following:
* project becomes less dependent on its initial authors
* other people can easily understand structure and behaviour of a program
* design decisions reuse becomes easier and safer
* it becomes possible to use real project for study purposesApplication
Foundation for Open Project Documentation gives a project a greater uderstandability and reusability potential, than Open Source foundation. It is loosely connected with
Free Software Foundation . OpenDoc project can also be commercial.Main principles
* The project documentation should be a base for source code, but not vice versa.
* The documentation should describe not only the final product, but also the creation process.
* The documentation should be easy to understand even for less qualified developers than its author.
* The documentation should be available every time anyone explores or modifies a project.References
External links
* [http://is.ifmo.ru/foundation_en Foundation for Open Project Documentation at Programming Technologies Department of SPbSU ITMO website]
* [http://is.ifmo.ru/foundation_en OpenDoc projects at Programming Technologies Department of SPbSU ITMO website]
Wikimedia Foundation. 2010.