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 |
|
Constraint check fails silently |
error |
|
Constraint check runs with incomplete data |
error |
|
Constraint check runs with invalid data |
error |
|
Constraint not checked during build |
error |
|
Constraint check runs with wrong data |
error |
|
Content contains syntax errors |
error |
|
Invalid meta-data in rst/md files leads to ignored Traceability objects |
error |
|
Dead link false positive |
error |
|
Dead link not detected |
error |
|
Duplicate ID is not detected |
error |
|
Dynamic functions return invalid meta-data |
error |
|
Function returns invalid value |
error |
|
Function gets not executed |
error |
|
Function returns no value |
error |
|
Dynamic functions return wrong meta-data |
error |
|
Function returns wrong calculated values |
error |
|
Exported needs.json file is corrupted |
error |
|
Exporting needs.json fails silently |
error |
|
Exported needs.json file is not valid |
error |
|
Bulk modification failes silently |
error |
|
Bulk modification of needs is not completed |
error |
|
Bulk modification of needs is not valid |
error |
|
ID already exists |
error |
|
ID format is invalid |
error |
|
ID generation failed |
error |
|
ID length is invalid |
error |
|
Importing needs is not accessible |
error |
|
Importing needs is not completed |
error |
|
Importing needs is not valid |
error |
|
Invalid link type used in a need |
error |
|
Link type value is not valid |
error |
|
Invalid option used in a need |
error |
|
Option value is not valid |
error |
|
Invalid status used in a need |
error |
|
Traceability objects content corrupted |
error |
|
Traceability objects meta-data corrupted |
error |
|
Corrupted external needs.json file |
error |
|
Invalid or incorrect filters used for external needs.json |
error |
|
Traceability objects links corrupted |
error |
|
Objects missing in needs.json |
error |
|
Missing external needs.json file |
error |
|
Meta-data missing |
error |
|
Wrong meta-data is used |
error |
|
Layout leads to incorrect information |
error |
|
Layout leads to incorrect rendering |
error |
|
Layout leads to missing information |
error |
|
Link target not found |
error |
|
Link target is not valid |
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 |
|
Manual ID already exists |
error |
|
Manual ID format is invalid |
error |
|
Manual ID length is invalid |
error |
|
Sphinx-Needs data not valid |
error |
|
Sphinx-Needs data is not process-compliant |
error |
|
Option value is not allowed |
error |
|
Permalink generation fails silently |
error |
|
Permalink links to non-existing need |
error |
|
Permalink is not valid |
error |
|
Permalink links to wrong need |
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 |
|
Template file is not a valid Jinja2 template |
error |
|
Template file not found |
error |
|
Template file contains syntax errors |
error |
|
Template file is not a valid Jinja2 template |
error |
|
Template file not found |
error |
|
Template file contains syntax errors |
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: 9 / 32
Errors without a mitigation: 71 / 74
Restrictions without error: 1 / 3
Checks without error: 0 / 0