Skip to content

itsallcode/openfasttrace-asciidoc-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OFT logo OpenFastTrace AsciiDoc Plugin

What is OpenFastTrace AsciiDoc Plugin?

This plugin allows OpenFastTrace (OFT) to parse and trace requirements in AsciiDoc files. Requirement tracing keeps track of whether you implemented everything you planned to in your specifications. It also identifies obsolete parts of your product and helps you to get rid of them.

For more details about requirement tracing and how to use OpenFastTrace, refer to the user guide.

[Place a screenshot of a tracing report generated using this plugin here]

Project Information

Build Maven Central Version

Sonarcloud status:

Quality Gate Status Bugs Code Smells Coverage Duplicated Lines (%) Lines of Code Reliability Rating Security Rating Technical Debt Maintainability Rating Vulnerabilities

What is AsciiDoc?

AsciiDoc is a human-readable document format, semantically equivalent to DocBook XML, but using plain-text mark-up conventions. AsciiDoc documents can be created using any text editor and can be viewed and edited in source form without requiring additional tools.

AsciiDoc is highly configurable: both the AsciiDoc source file syntax and the backend output markups (which can be almost any type of SGML/XML markup) can be customized and extended by the user.

How does AsciiDoc fit into OFT?

In the context of OpenFastTrace (OFT), AsciiDoc files can be used to write the software requirements specification. The AsciiDoc format allows for requirement IDs to be embedded in the text, which can then be traced by OFT.

Using the AsciiDoc Plugin, OFT is able to read and parse AsciiDoc files, trace the requirements mentioned in the files, and generate a requirement tracing report. This allows for easy tracking of the implementation status of each requirement directly from the specification document.

User Guides

News and Discussions

Information for Contributors

Using OpenFastTrace AsciiDoc Plugin

The plugin can be used with the standard OFT command line, integrated into Maven or Gradle build cycles, or applied through a continuous integration pipeline.

For more detailed information on how to use OpenFastTrack with AsciiDoc Plugin, consult our user guide.

Getting OpenFastTrace AsciiDoc Plugin

The OpenFastTrace AsciiDoc Plugin is supplied as a Java Archive (JAR) which can be obtained from:

More details about adding the plugin to an existing establishment are outlined in the developer guide.

Installation

Runtime Dependencies

OpenFastTrace AsciiDoc Plugin needs a Java 17 (or later) runtime environment to run properly.

Installation of Runtime Dependencies on Linux

Ubuntu or Debian

To install Java Runtime Environment:

apt-get install openjdk-17-jre

Running OpenFastTrace With the AsciiDoc Plugin

To run OFT with the plugin, you can add the plugin to the Java classpath or one of OFT's plugin search directories.

For more details, please check out the OFT user guide's chapter on plugins.