Merge branch 'develop' of https://github.com/itsallcode/openfasttrace-architecture-template.git into develop

Author: redcatbear

README.md

@@ -73,9 +73,15 @@ We recommend using [Eclipse](https://eclipse.org), the built-in WikiText editor
 
 Read the [OpenFastTrace User Guide](https://github.com/itsallcode/openfasttrace/blob/master/doc/user_guide.md) to learn how to create specifications in the OFT Markdown format.
 
-### Document Title and Authors
+### Stripping the OFT Comments
 
-Start the 
+The template contains a lot of comments in the form of Markdown quotes starting with "OFT:". You can strip them with your editors multi-file search and replace function (e.g. CRTL+H in Eclipse).
+
+Or you can use command line tools like `sed`. Run the script below on the root directory of the architecture template.
+
+```bash
+find src/doc -name '*.md' -exec sed -i -e '/^>\s*OFT:.*/d' {} \;
+```
 
 ## Building
 
@@ -181,4 +187,4 @@ Check the links in the generated HTML docuements:
 linkchecker --check-extern target/*.html
 ```
 
-If you remove the command line switch `--check-extern` only local links are checked. 
+If you remove the command line switch `--check-extern` only local links are checked. 

pom.xml

@@ -26,6 +26,7 @@
       runtime_view/paying_with_credit_card.md deployment_view.md
       concepts.md design_decisions.md quality_scenarios.md risks.md
       glossary.md bibliography.md</spec.files>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <!-- Do not change the properties below -->
     <spec.source.directory>${project.basedir}/src/doc</spec.source.directory>
     <spec.source.css.directory>${spec.source.directory}/css</spec.source.css.directory>
@@ -190,4 +191,4 @@
       </plugin>
     </plugins>
   </build>
-</project>
+</project>

src/doc/introduction.md

@@ -27,7 +27,7 @@ The target audience are persons involved with the construction of the system, te
 
 ### Notational Conventions
 
-Requirements in this document are written in "Requirment enhanced Markdown format" which is the native specification format of [OpenFastTrace (OFT)](https://github.com/itsallcode/openfasttrace). If you want to learn more about this format please check the [OpenFastTrace User Guide](https://github.com/itsallcode/openfasttrace/blob/master/doc/user_guide.md).
+Requirements in this document are written in "Requirement enhanced Markdown format" which is the native specification format of [OpenFastTrace (OFT)](https://github.com/itsallcode/openfasttrace). If you want to learn more about this format please check the [OpenFastTrace User Guide](https://github.com/itsallcode/openfasttrace/blob/master/doc/user_guide.md).
 
 Using this format allows you to scan the requirement chain using OFT to see if all requirements from the user-level [System Requirement Specification (SRS)](bibliography.md#srs) are covered.