This document presents the goals of the StrictDoc project and describes how the project is developed.
1. Project goals
StrictDoc is an attempt to create an open source tool for writing technical requirements specifications.
UID: | GOAL-1-TOOL-SUPPORT |
---|---|
child refs: | |
Statement: |
There shall exist free and lightweight yet capable software for writing requirements and specifications documents |
Comment: |
Technical documentation is hard, it can be an extremely laborious process. Software shall support engineers in their work with documentation. |
UID: | GOAL-2-REDUCE-DOCUMENTATION-HAZARDS |
---|---|
Statement: |
There shall exist no (or less) opportunity for writing incorrect or inconsistent documentation. |
Comment: |
Every serious engineering activity, such as safety engineering or systems engineering, starts with requirements. The more critical is a product the higher the importance of good documentation. Technical documentation can be and often becomes a source of hazards. It is recognized that many failures stem from inadequate requirements engineering. While it is not possible to fix the problem of inadequate requirements engineering in general, it is definitely possible to improve software that supports engineers in activities such as requirements engineering and writing technical documentation. |
UID: | GOAL-3-NO-RUNAWAY-DOCUMENTATION |
---|---|
Statement: |
Software shall support engineers in keeping documentation up-to-date. |
Comment: |
Technical documentation easily becomes outdated. Many existing tools for documentation do not provide any measures for ensuring overall consistency of documents and documentation trees. |
UID: | GOAL-4-CHANGE-MANAGEMENT |
---|---|
Statement: |
Software shall provide capabilities for change management and impact assessment. |
Comment: |
Change management is difficult. The bigger the project is, the harder it is to maintain its documentation. If a change is introduced to a project, it usually requires a full revision of its requirements. |
Comment: |
When the basic capabilities of StrictDoc are in place, it should be possible to do a more advanced analysis of requirements and requirement trees:
|
2. User interfaces
There are two user interfaces for StrictDoc:
- Command-line interface (CLI)
- Web interface
The CLI interface is already developed, the web interface is (slow) work-in-progress.
UID: | UI-1-TEXT |
---|---|
Statement: |
StrictDoc shall provide a command-line interface. |
UID: | UI-2-WEB |
---|---|
Statement: |
StrictDoc shall provide a web interface. |
3. Development team
StrictDoc is a spare time project developed and maintained by two people with occasional contributions from the Open Source community.