OWASP PenText Project - Revision history

Peter Mosmans: Correct grammar, update names and timeline

2017-10-15T23:17:58Z

Correct grammar, update names and timeline

Peter Mosmans: fixed links

2016-09-16T09:55:20Z

fixed links

Peter Mosmans at 17:11, 3 August 2016

2016-08-03T17:11:01Z

Peter Mosmans: /* Contributors */

2016-07-21T12:16:32Z

‎Contributors

Peter Mosmans: /* Technical information */

2016-07-21T10:57:36Z

‎Technical information

Peter Mosmans: /* Contributors */

2016-07-21T10:55:30Z

‎Contributors

Peter Mosmans: /* Contributors */

2016-07-21T10:43:09Z

‎Contributors

Peter Mosmans: /* Roadmap */

2016-07-21T10:39:51Z

‎Roadmap

Peter Mosmans: /* Getting Involved */

2016-07-21T10:38:18Z

‎Getting Involved

Peter Mosmans: /* Roadmap */

2016-07-21T10:37:16Z

‎Roadmap

@@ Line 28: / Line 28: @@
 == Project Leader ==
-This project is managed by Radically Open Security members Deborah, Patricia and Peter Mosmans. They can be reached at [mailto:info@pentext.org info@pentext.org].
+This project is managed by Radically Open Security members Patricia Piolon and Peter Mosmans. They can be reached at [mailto:info@pentext.org info@pentext.org].
 ==Classifications==
@@ Line 53: / Line 53: @@
 ==If I am not a programmer can I participate in your project?==
-Yes, you can certainly participate in the project if you are not a programmer or technical. The project needs different skills and expertise and different times during its development. Currently, we are looking for writers and translators.   See the Road Map and Getting Involved tab for more details.
+Yes, you can certainly participate in the project if you are not a programmer or technical. The project needs different skills and expertise and different times during its development. Currently, we are looking for writers and translators. See the Road Map and Getting Involved tab for more details.
 = Acknowledgements =
 ==Contributors==
-The Pentext XML Documentation Project is developed by a worldwide team working at [https://www.radicallyopensecurity.com Radically Open Security]. A live update of project [https://github.com/radicallyopensecurity/pentext/graphs/contributors contributors is found here].
+The Pentext XML Documentation Project is developed by a worldwide team working at [https://www.radicallyopensecurity.com Radically Open Security]. A live update of project [https://github.com/radicallyopensecurity/pentext/graphs/contributors contributors can be found here].
 The first contributors to the project were:
@@ Line 69: / Line 69: @@
 ==Roadmap==
-As of '''June, 2016, the highest priorities for the next 6 months are''':
+As of '''October 2017, the highest priorities for the next 6 months are''':
 * Create additional content for Forensics, code audits and such
@@ Line 93: / Line 93: @@
 Please [mailto:info@pentext.org mail us] for feedback:
 <ul>
-<li>What do like?</li>
+<li>What do you like?</li>
 <li>What don't you like?</li>
 <li>What features would you like to see prioritized on the roadmap?</li>

@@ Line 10: / Line 10: @@
 ==Description==
-The OWASP PenText XML documentation project can help your software security company produce offers, reports, invoices and generic documents by offering a well-structured and easy to maintain documenting system you can modify to your liking. The XML content is multilingual (current languages: English and Dutch) and can be easily adapted - by editing the constants provided in each document - or expanded - by creating new files. Both reports and offers are comprised of smaller snippets, i.e. template texts containing, respectively, offerte text or common vulnerabilities, which can be included where relevant. The XSLT can be customized by anyone versed in XSLT. To get started it is neccessary to install a few Open Source tools. Please visit our [https://github.com/radicallyopensecurity/templates/blob/master/xml/doc/Tools%20manual.md documentation page] on how to set up the environment.
+The OWASP PenText XML documentation project can help your software security company produce offers, reports, invoices and generic documents by offering a well-structured and easy to maintain documenting system you can modify to your liking. The XML content is multilingual (current languages: English and Dutch) and can be easily adapted - by editing the constants provided in each document - or expanded - by creating new files. Both reports and offers are comprised of smaller snippets, i.e. template texts containing, respectively, offerte text or common vulnerabilities, which can be included where relevant. The XSLT can be customized by anyone versed in XSLT. To get started it is neccessary to install a few Open Source tools. Please visit our [https://github.com/radicallyopensecurity/pentext/blob/master/xml/doc/Tools%20manual.md documentation page] on how to set up the environment.
 ==Technical information==
@@ Line 28: / Line 28: @@
 == Project Leader ==
-This project is managed by Radically Open Security members Deborah, Patricia and Peter. They can be reached at [mailto:info@pentext.org info@pentext.org].
+This project is managed by Radically Open Security members Deborah, Patricia and Peter Mosmans. They can be reached at [mailto:info@pentext.org info@pentext.org].
 ==Classifications==
@@ Line 58: / Line 58: @@
 ==Contributors==
-The Pentext XML Documentation Project is developed by a worldwide team working at [https://www.radicallyopensecurity.com Radically Open Security]. A live update of project [https://github.com/radicallyopensecurity/templates/graphs/contributors contributors is found here].
+The Pentext XML Documentation Project is developed by a worldwide team working at [https://www.radicallyopensecurity.com Radically Open Security]. A live update of project [https://github.com/radicallyopensecurity/pentext/graphs/contributors contributors is found here].
 The first contributors to the project were:
 * XSLT coding and documentation by Patricia Piolon
-* ChatOps scripts by Peter and John
+* ChatOps scripts by Peter Mosmans and John
-* XML content by Peter, Christine, Deborah, Marcus Bointon and others.
+* XML content by Peter Mosmans, Christine, Deborah, Marcus Bointon and others.
 = Road Map and Getting Involved =

@@ Line 21: / Line 21: @@
 == Project Resources ==
-[https://github.com/radicallyopensecurity/templates Sources]
+[https://github.com/radicallyopensecurity/pentext sources]
-[https://github.com/radicallyopensecurity/templates/tree/master/xml/doc Documentation]
+[https://github.com/radicallyopensecurity/pentext/tree/master/xml/doc]
-[https://github.com/radicallyopensecurity/templates/issues Issue Tracker]
+[https://github.com/radicallyopensecurity/pentext/issues Issue Tracker]
 == Project Leader ==
@@ Line 63: / Line 63: @@
 * XSLT coding and documentation by Patricia Piolon
-* Additional validation scripting by Peter
+* ChatOps scripts by Peter and John
 * XML content by Peter, Christine, Deborah, Marcus Bointon and others.

@@ Line 64: / Line 64: @@
 * XSLT coding and documentation by Patricia Piolon
 * Additional validation scripting by Peter
-* XML content by Peter, Christine, Deborah, Marcus and others.
+* XML content by Peter, Christine, Deborah, Marcus Bointon and others.
 = Road Map and Getting Involved =

@@ Line 13: / Line 13: @@
 ==Technical information==
-The OWASP PenText project is based on XML. A PenText Report, Offer, Invoice or Generic Document is in fact a (modular) XML document, conforming to an XML Schema. The XML Schema ensures that the documents are structured correctly, so that they can then be transformed into other formats using XSLT and the SAXON XSLT processor.
+The OWASP PenText project is based on XML. A PenText Report, Offer, Invoice or Generic Document is in fact a (modular) XML document, conforming to an XML Schema. The XML Schema ensures that the documents are structured correctly, so that they can then be transformed into other formats using XSLT and the [http://saxon.sourceforge.net/#F9.7HE SAXON XSLT processor].
-Currently there is only one target format: PDF. To produce the PDF document, the report, offer, invoice or generic document XML is first transformed into XSL-FO (XSL Formatting Objects), which is then converted to PDF using Apache FOP.
+Currently there is only one target format: PDF. To produce the PDF document, the report, offer, invoice or generic document XML is first transformed into XSL-FO (XSL Formatting Objects), which is then converted to PDF using [https://xmlgraphics.apache.org/fop/ Apache FOP].
 ==Licensing==

@@ Line 71: / Line 71: @@
 * Get others to provide translations for the snippet library
-Subsequent Releases will add
+Subsequent Releases would preferably contain
-<strong>
-* Internationalization Support
+* Templates in a wider variety of languages
 ==Getting Involved==

@@ Line 81: / Line 81: @@
 Some of the ways you can help are as follows:
 ===Localization===
 Are you fluent in another language? Can you help translate the snippets and strings in the <strong>PenText XML documentation project</strong> into that language?