Sphinx-Needs¶
Sphinx makes it easy to create intelligent and beautiful documentation.
|
Analysis¶
ID |
Title |
Type |
---|---|---|
Sphinx-Needs needs.json file |
artifact |
|
Do not use dynamic functions |
restriction |
|
Programmatic errors in rst/md files result in ignored Traceability objects |
error |
|
Content contains syntax errors |
error |
|
Invalid meta-data in rst/md files leads to ignored Traceability objects |
error |
|
Dynamic functions return invalid meta-data |
error |
|
Function returns invalid value |
error |
|
Function gets not executed |
error |
|
Dynamic functions return wrong meta-data |
error |
|
Function returns wrong calculated values |
error |
|
Traceability objects meta-data corrupted |
error |
|
Corrupted external needs.json file |
error |
|
Invalid or incorrect filters used for external needs.json |
error |
|
Objects missing in needs.json |
error |
|
Missing external needs.json file |
error |
|
Meta-data missing |
error |
|
Wrong meta-data is used |
error |
|
External needs corrupted |
error |
|
Links missing |
error |
|
Back-links are not set |
error |
|
External needs not found |
error |
|
Internal target link is not found |
error |
|
Sphinx-Needs data not valid |
error |
|
Sphinx-Needs data is not process-compliant |
error |
|
Authentication issues with needsservice |
error |
|
External service unreachable by needsservice |
error |
|
needsservice unable to process data from external service |
error |
|
Syntax errors in rst/md files cause Traceability objects to be ignored |
error |
|
Display Traceability objects content in Sphinx-Needs |
feature |
|
Generate object representation in Sphinx-Needs |
feature |
|
Apply dynamic functions for meta-data computation |
feature |
|
Export needs.json file using Sphinx-Needs |
feature |
|
Establish links between Traceability objects in Sphinx-Needs |
feature |
|
Read Traceability objects in Sphinx-Needs |
feature |
|
Assign meta-data to Traceability objects in Sphinx-Needs |
feature |
|
Enhance Need content using templates in Sphinx-Needs |
feature |
|
Extend page content with templates in Sphinx-Needs |
feature |
|
Automatic ID generation |
feature |
|
Configuration via conf.py or an external TOML file |
feature |
|
Customizable layouts for need presentation |
feature |
|
Customizable link types |
feature |
|
Customizable need options |
feature |
|
Definable need types |
feature |
|
Create a bar chart based on need statistics (needbar) |
feature |
|
Modify existing needs in bulk (needextend) |
feature |
|
Render a PlantUML flow diagram of needs (needflow) |
feature |
|
Import needs from an external JSON file (needimport) |
feature |
|
Create a pie chart based on need statistics (needpie) |
feature |
|
Display needs in a filterable table (needtable) |
feature |
|
Constraint checking to validate need relationships |
feature |
|
JSON builder to export all need data |
feature |
|
Permalink generation to specific need objects |
feature |
|
Bidirectional link tracking |
feature |
|
Dead link detection and warnings |
feature |
|
Direct linking between needs using IDs |
feature |
|
Manual ID assignment |
feature |
|
In-content need parts for granular references |
feature |
|
Need status enforcement |
feature |
|
Tagging support |
feature |
|
Unique ID enforcement and checks |
feature |
|
Clean full build |
restriction |
|
Warning to Error |
restriction |
|
Sphinx-Needs |
tool |
✅ Compliance statistics
Features without errors: 25 / 32
Errors without a mitigation: 23 / 26
Restrictions without error: 1 / 3
Checks without error: 0 / 0