add: ascii-art to describe the process

This commit is contained in:
Alexandre Dulaunoy 2017-10-15 11:13:58 +02:00
parent 786c14f467
commit 0c0f65b1cd
Signed by: adulau
GPG key ID: 09E2CD4944E6CBCD
4 changed files with 128 additions and 71 deletions

43
raw.md
View file

@ -5,7 +5,7 @@
% ipr= "trust200902" % ipr= "trust200902"
% area = "Security" % area = "Security"
% %
% date = 2017-09-27T00:00:00Z % date = 2017-10-15T00:00:00Z
% %
% [[author]] % [[author]]
% initials="A." % initials="A."
@ -19,7 +19,7 @@
% [author.address.postal] % [author.address.postal]
% street = "16, bd d'Avranches" % street = "16, bd d'Avranches"
% city = "Luxembourg" % city = "Luxembourg"
% code = "L-1611" % code = "L-1160"
% country = "Luxembourg" % country = "Luxembourg"
% [[author]] % [[author]]
% initials="A." % initials="A."
@ -33,11 +33,9 @@
% [author.address.postal] % [author.address.postal]
% street = "16, bd d'Avranches" % street = "16, bd d'Avranches"
% city = "Luxembourg" % city = "Luxembourg"
% code = "L-1611" % code = "L-1160"
% country = "Luxembourg" % country = "Luxembourg"
.# Abstract .# Abstract
This document describes the Programming Methodology Framework also known under the PMF methodology. The methodology is based on the manifesto written by Zed A. Shaw [@?PROGRAMMING-MF-MANIFESTO] which This document describes the Programming Methodology Framework also known under the PMF methodology. The methodology is based on the manifesto written by Zed A. Shaw [@?PROGRAMMING-MF-MANIFESTO] which
@ -62,6 +60,30 @@ The overall concept of PMF methodology follows the following process:
Repeat the above process until the software is delivered. Repeat the above process until the software is delivered.
A simplified overview of the process can be described as follow:
~~~~~ ascii-art
+----------+
| |
| idea <------+
| | |
+----+-----+ |
| |
| |
+----v-----+ |
| | | it doesn't work
| code | |
| | |
+----+-----+ |
| |
| |
+----v-----+ |
| | |
| release +------+
| |
+----------+
~~~~~
## Management and PMF methodology ## Management and PMF methodology
A simple management process is a required of the PMF methodology. A simple management process is a required of the PMF methodology.
@ -103,15 +125,4 @@ The authors wish to thank all the programmers who program.
</front> </front>
</reference> </reference>
<reference anchor='JSON-SCHEMA' target='https://tools.ietf.org/html/draft-wright-json-schema'>
<front>
<title>JSON Schema: A Media Type for Describing JSON Documents</title>
<author initials='' surname='' fullname='Austin Wright'></author>
<date year="2016"></date>
</front>
</reference>
{backmatter} {backmatter}

View file

@ -390,7 +390,7 @@
<meta name="dct.creator" content="Dulaunoy, A. and A. Iklody" /> <meta name="dct.creator" content="Dulaunoy, A. and A. Iklody" />
<meta name="dct.identifier" content="urn:ietf:id:draft-dulaunoy-programming-methodology-framework" /> <meta name="dct.identifier" content="urn:ietf:id:draft-dulaunoy-programming-methodology-framework" />
<meta name="dct.issued" scheme="ISO8601" content="2017-9-27" /> <meta name="dct.issued" scheme="ISO8601" content="2017-10-15" />
<meta name="dct.abstract" content="This document describes the Programming Methodology Framework also known under the PMF methodology. The methodology is based on the manifesto written by Zed A. Shaw " /> <meta name="dct.abstract" content="This document describes the Programming Methodology Framework also known under the PMF methodology. The methodology is based on the manifesto written by Zed A. Shaw " />
<meta name="description" content="This document describes the Programming Methodology Framework also known under the PMF methodology. The methodology is based on the manifesto written by Zed A. Shaw " /> <meta name="description" content="This document describes the Programming Methodology Framework also known under the PMF methodology. The methodology is based on the manifesto written by Zed A. Shaw " />
@ -414,8 +414,8 @@
<td class="right">CIRCL</td> <td class="right">CIRCL</td>
</tr> </tr>
<tr> <tr>
<td class="left">Expires: March 31, 2018</td> <td class="left">Expires: April 18, 2018</td>
<td class="right">September 27, 2017</td> <td class="right">October 15, 2017</td>
</tr> </tr>
@ -435,7 +435,7 @@
<p>This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.</p> <p>This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.</p>
<p>Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at http://datatracker.ietf.org/drafts/current/.</p> <p>Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at http://datatracker.ietf.org/drafts/current/.</p>
<p>Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."</p> <p>Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."</p>
<p>This Internet-Draft will expire on March 31, 2018.</p> <p>This Internet-Draft will expire on April 18, 2018.</p>
<h1 id="rfc.copyrightnotice"> <h1 id="rfc.copyrightnotice">
<a href="#rfc.copyrightnotice">Copyright Notice</a> <a href="#rfc.copyrightnotice">Copyright Notice</a>
</h1> </h1>
@ -475,6 +475,28 @@
<p> </p> <p> </p>
<p id="rfc.section.1.p.6">Repeat the above process until the software is delivered. </p> <p id="rfc.section.1.p.6">Repeat the above process until the software is delivered. </p>
<p id="rfc.section.1.p.7">A simplified overview of the process can be described as follow: </p>
<pre>
+----------+
| |
| idea &lt;------+
| | |
+----+-----+ |
| |
| |
+----v-----+ |
| | | it doesn't work
| code | |
| | |
+----+-----+ |
| |
| |
+----v-----+ |
| | |
| release +------+
| |
+----------+
</pre>
<h1 id="rfc.section.1.1"><a href="#rfc.section.1.1">1.1.</a> <a href="#management-and-pmf-methodology" id="management-and-pmf-methodology">Management and PMF methodology</a></h1> <h1 id="rfc.section.1.1"><a href="#rfc.section.1.1">1.1.</a> <a href="#management-and-pmf-methodology" id="management-and-pmf-methodology">Management and PMF methodology</a></h1>
<p id="rfc.section.1.1.p.1">A simple management process is a required of the PMF methodology. The management process is meant to be complementary instead of interfering with the programming aspect and solely serves to support the PMF methodology. </p> <p id="rfc.section.1.1.p.1">A simple management process is a required of the PMF methodology. The management process is meant to be complementary instead of interfering with the programming aspect and solely serves to support the PMF methodology. </p>
<p/> <p/>
@ -539,7 +561,7 @@
<span class="vcardline"> <span class="vcardline">
<span class="locality">Luxembourg</span>, <span class="locality">Luxembourg</span>,
<span class="region"></span> <span class="region"></span>
<span class="code">L-1611</span> <span class="code">L-1160</span>
</span> </span>
<span class="country-name vcardline">Luxembourg</span> <span class="country-name vcardline">Luxembourg</span>
</span> </span>
@ -563,7 +585,7 @@
<span class="vcardline"> <span class="vcardline">
<span class="locality">Luxembourg</span>, <span class="locality">Luxembourg</span>,
<span class="region"></span> <span class="region"></span>
<span class="code">L-1611</span> <span class="code">L-1160</span>
</span> </span>
<span class="country-name vcardline">Luxembourg</span> <span class="country-name vcardline">Luxembourg</span>
</span> </span>

View file

@ -5,7 +5,7 @@
Network Working Group A. Dulaunoy Network Working Group A. Dulaunoy
Internet-Draft A. Iklody Internet-Draft A. Iklody
Intended status: Informational CIRCL Intended status: Informational CIRCL
Expires: March 31, 2018 September 27, 2017 Expires: April 18, 2018 October 15, 2017
Programming Methodology Framework aka PMF Programming Methodology Framework aka PMF
@ -37,7 +37,7 @@ Status of This Memo
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on March 31, 2018. This Internet-Draft will expire on April 18, 2018.
Copyright Notice Copyright Notice
@ -53,9 +53,9 @@ Copyright Notice
Dulaunoy & Iklody Expires March 31, 2018 [Page 1] Dulaunoy & Iklody Expires April 18, 2018 [Page 1]
Internet-Draft PMF - Programming Methodology Framework September 2017 Internet-Draft PMF - Programming Methodology Framework October 2017
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
@ -68,10 +68,10 @@ Table of Contents
1.1. Management and PMF methodology . . . . . . . . . . . . . 3 1.1. Management and PMF methodology . . . . . . . . . . . . . 3
1.2. Conventions and Terminology . . . . . . . . . . . . . . . 3 1.2. Conventions and Terminology . . . . . . . . . . . . . . . 3
2. Security Considerations . . . . . . . . . . . . . . . . . . . 3 2. Security Considerations . . . . . . . . . . . . . . . . . . . 3
3. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 3 3. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 4
4. References . . . . . . . . . . . . . . . . . . . . . . . . . 3 4. References . . . . . . . . . . . . . . . . . . . . . . . . . 4
4.1. Normative References . . . . . . . . . . . . . . . . . . 3 4.1. Normative References . . . . . . . . . . . . . . . . . . 4
4.2. Informative References . . . . . . . . . . . . . . . . . 3 4.2. Informative References . . . . . . . . . . . . . . . . . 4
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 4 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 4
1. Introduction 1. Introduction
@ -104,16 +104,36 @@ Table of Contents
Repeat the above process until the software is delivered. Repeat the above process until the software is delivered.
A simplified overview of the process can be described as follow:
Dulaunoy & Iklody Expires April 18, 2018 [Page 2]
Dulaunoy & Iklody Expires March 31, 2018 [Page 2]
Internet-Draft PMF - Programming Methodology Framework September 2017 Internet-Draft PMF - Programming Methodology Framework October 2017
+----------+
| |
| idea <------+
| | |
+----+-----+ |
| |
| |
+----v-----+ |
| | | it doesn't work
| code | |
| | |
+----+-----+ |
| |
| |
+----v-----+ |
| | |
| release +------+
| |
+----------+
1.1. Management and PMF methodology 1.1. Management and PMF methodology
A simple management process is a required of the PMF methodology. A simple management process is a required of the PMF methodology.
@ -140,6 +160,16 @@ Internet-Draft PMF - Programming Methodology Framework September 2017
programming and this also includes the act of simplifying or removing programming and this also includes the act of simplifying or removing
code to reduce the attack surface. code to reduce the attack surface.
Dulaunoy & Iklody Expires April 18, 2018 [Page 3]
Internet-Draft PMF - Programming Methodology Framework October 2017
3. Acknowledgements 3. Acknowledgements
The authors wish to thank all the programmers who program. The authors wish to thank all the programmers who program.
@ -163,19 +193,12 @@ Internet-Draft PMF - Programming Methodology Framework September 2017
James, , "The Tao of Programming", James, , "The Tao of Programming",
<http://www.mit.edu/~xela/tao.html>. <http://www.mit.edu/~xela/tao.html>.
Dulaunoy & Iklody Expires March 31, 2018 [Page 3]
Internet-Draft PMF - Programming Methodology Framework September 2017
Authors' Addresses Authors' Addresses
Alexandre Dulaunoy Alexandre Dulaunoy
Computer Incident Response Center Luxembourg Computer Incident Response Center Luxembourg
16, bd d'Avranches 16, bd d'Avranches
Luxembourg L-1611 Luxembourg L-1160
Luxembourg Luxembourg
Phone: +352 247 88444 Phone: +352 247 88444
@ -185,7 +208,7 @@ Authors' Addresses
Andras Iklody Andras Iklody
Computer Incident Response Center Luxembourg Computer Incident Response Center Luxembourg
16, bd d'Avranches 16, bd d'Avranches
Luxembourg L-1611 Luxembourg L-1160
Luxembourg Luxembourg
Phone: +352 247 88444 Phone: +352 247 88444
@ -198,27 +221,4 @@ Authors' Addresses
Dulaunoy & Iklody Expires April 18, 2018 [Page 4]
Dulaunoy & Iklody Expires March 31, 2018 [Page 4]

View file

@ -18,7 +18,7 @@
<postal> <postal>
<street>16, bd d'Avranches</street> <street>16, bd d'Avranches</street>
<city>Luxembourg</city> <city>Luxembourg</city>
<code>L-1611</code> <code>L-1160</code>
<country>Luxembourg</country> <country>Luxembourg</country>
<region></region> <region></region>
</postal> </postal>
@ -33,7 +33,7 @@
<postal> <postal>
<street>16, bd d'Avranches</street> <street>16, bd d'Avranches</street>
<city>Luxembourg</city> <city>Luxembourg</city>
<code>L-1611</code> <code>L-1160</code>
<country>Luxembourg</country> <country>Luxembourg</country>
<region></region> <region></region>
</postal> </postal>
@ -42,7 +42,7 @@
<uri></uri> <uri></uri>
</address> </address>
</author> </author>
<date year="2017" month="September" day="27"/> <date year="2017" month="October" day="15"/>
<area>Security</area> <area>Security</area>
<workgroup></workgroup> <workgroup></workgroup>
@ -78,6 +78,30 @@ to official engineering or project documents describing one of the most used sof
</t> </t>
<t>Repeat the above process until the software is delivered. <t>Repeat the above process until the software is delivered.
</t> </t>
<t>A simplified overview of the process can be described as follow:
</t>
<figure align="center"><artwork align="center" type="ascii-art">
+----------+
| |
| idea &lt;------+
| | |
+----+-----+ |
| |
| |
+----v-----+ |
| | | it doesn't work
| code | |
| | |
+----+-----+ |
| |
| |
+----v-----+ |
| | |
| release +------+
| |
+----------+
</artwork></figure>
<section anchor="management-and-pmf-methodology" title="Management and PMF methodology"> <section anchor="management-and-pmf-methodology" title="Management and PMF methodology">
<t>A simple management process is a required of the PMF methodology. <t>A simple management process is a required of the PMF methodology.