chg: [PMF] first release as Internet-Draft

This commit is contained in:
Alexandre Dulaunoy 2019-04-11 21:43:18 +02:00
parent bedd090cb4
commit a756bac046
Signed by: adulau
GPG key ID: 09E2CD4944E6CBCD
5 changed files with 122 additions and 117 deletions

View file

@ -1,6 +1,6 @@
MMARK:=/home/adulau/git/mmark/mmark/mmark -xml2 -page
docs = $(wildcard *.md)
docs = $(wildcard raw.md)
all: $(docs)
$(MMARK) $< > $<.xml

2
raw.md
View file

@ -6,7 +6,7 @@
% area = "Internet"
% keyword = ["software engineering", "engineering", "pmf", "programming"]
%
% date = 2017-10-15T00:00:00Z
% date = 2019-04-11T00:00:00Z
%
% [[author]]
% initials="A."

View file

@ -373,24 +373,24 @@
/*]]>*/
</style>
<link href="#rfc.toc" rel="Contents"/>
<link href="#rfc.section.1" rel="Chapter" title="1 Introduction"/>
<link href="#rfc.section.1.1" rel="Chapter" title="1.1 Management and PMF methodology"/>
<link href="#rfc.section.1.2" rel="Chapter" title="1.2 Conventions and Terminology"/>
<link href="#rfc.section.2" rel="Chapter" title="2 Security Considerations"/>
<link href="#rfc.section.3" rel="Chapter" title="3 Acknowledgements"/>
<link href="#rfc.references" rel="Chapter" title="4 References"/>
<link href="#rfc.references.1" rel="Chapter" title="4.1 Normative References"/>
<link href="#rfc.references.2" rel="Chapter" title="4.2 Informative References"/>
<link href="#rfc.authors" rel="Chapter"/>
<link href="#rfc.toc" rel="Contents">
<link href="#rfc.section.1" rel="Chapter" title="1 Introduction">
<link href="#rfc.section.1.1" rel="Chapter" title="1.1 Management and PMF methodology">
<link href="#rfc.section.1.2" rel="Chapter" title="1.2 Conventions and Terminology">
<link href="#rfc.section.2" rel="Chapter" title="2 Security Considerations">
<link href="#rfc.section.3" rel="Chapter" title="3 Acknowledgements">
<link href="#rfc.references" rel="Chapter" title="4 References">
<link href="#rfc.references.1" rel="Chapter" title="4.1 Normative References">
<link href="#rfc.references.2" rel="Chapter" title="4.2 Informative References">
<link href="#rfc.authors" rel="Chapter">
<meta name="generator" content="xml2rfc version 2.5.1 - http://tools.ietf.org/tools/xml2rfc" />
<meta name="generator" content="xml2rfc version 2.9.6 - https://tools.ietf.org/tools/xml2rfc" />
<link rel="schema.dct" href="http://purl.org/dc/terms/" />
<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.issued" scheme="ISO8601" content="2017-10-15" />
<meta name="dct.issued" scheme="ISO8601" content="2019-04-11" />
<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 " />
@ -414,8 +414,8 @@
<td class="right">CIRCL</td>
</tr>
<tr>
<td class="left">Expires: April 18, 2018</td>
<td class="right">October 15, 2017</td>
<td class="left">Expires: October 13, 2019</td>
<td class="right">April 11, 2019</td>
</tr>
@ -425,47 +425,52 @@
<p class="title">Programming Methodology Framework aka PMF<br />
<span class="filename">draft-dulaunoy-programming-methodology-framework</span></p>
<h1 id="rfc.abstract">
<a href="#rfc.abstract">Abstract</a>
</h1>
<p>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 <a href="#PROGRAMMING-MF-MANIFESTO">[PROGRAMMING-MF-MANIFESTO]</a> which describes a natural approach to software engineering with a strong focus on the act of programming. The PM methodology uses a soft naming to allow for a non-partisan reference to official engineering or project documents describing one of the most used software engineering methodologies. </p>
<h1 id="rfc.status">
<a href="#rfc.status">Status of This Memo</a>
</h1>
<h1 id="rfc.abstract"><a href="#rfc.abstract">Abstract</a></h1>
<p>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 <a href="#PROGRAMMING-MF-MANIFESTO" class="xref">[PROGRAMMING-MF-MANIFESTO]</a> which describes a natural approach to software engineering with a strong focus on the act of programming. The PMF methodology uses a soft naming to allow for a non-partisan reference to official engineering or project documents describing one of the most used software engineering methodologies. </p>
<h1 id="rfc.status"><a href="#rfc.status">Status of This Memo</a></h1>
<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 https://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>This Internet-Draft will expire on April 18, 2018.</p>
<h1 id="rfc.copyrightnotice">
<a href="#rfc.copyrightnotice">Copyright Notice</a>
</h1>
<p>Copyright (c) 2017 IETF Trust and the persons identified as the document authors. All rights reserved.</p>
<p>This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.</p>
<p>This Internet-Draft will expire on October 13, 2019.</p>
<h1 id="rfc.copyrightnotice"><a href="#rfc.copyrightnotice">Copyright Notice</a></h1>
<p>Copyright (c) 2019 IETF Trust and the persons identified as the document authors. All rights reserved.</p>
<p>This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.</p>
<hr class="noprint" />
<h1 class="np" id="rfc.toc"><a href="#rfc.toc">Table of Contents</a></h1>
<ul class="toc">
<li>1. <a href="#rfc.section.1">Introduction</a></li>
<ul><li>1.1. <a href="#rfc.section.1.1">Management and PMF methodology</a></li>
<li>1.2. <a href="#rfc.section.1.2">Conventions and Terminology</a></li>
</ul><li>2. <a href="#rfc.section.2">Security Considerations</a></li>
<li>3. <a href="#rfc.section.3">Acknowledgements</a></li>
<li>4. <a href="#rfc.references">References</a></li>
<ul><li>4.1. <a href="#rfc.references.1">Normative References</a></li>
<li>4.2. <a href="#rfc.references.2">Informative References</a></li>
</ul><li><a href="#rfc.authors">Authors' Addresses</a></li>
<li>1. <a href="#rfc.section.1">Introduction</a>
</li>
<ul><li>1.1. <a href="#rfc.section.1.1">Management and PMF methodology</a>
</li>
<li>1.2. <a href="#rfc.section.1.2">Conventions and Terminology</a>
</li>
</ul><li>2. <a href="#rfc.section.2">Security Considerations</a>
</li>
<li>3. <a href="#rfc.section.3">Acknowledgements</a>
</li>
<li>4. <a href="#rfc.references">References</a>
</li>
<ul><li>4.1. <a href="#rfc.references.1">Normative References</a>
</li>
<li>4.2. <a href="#rfc.references.2">Informative References</a>
</li>
</ul><li><a href="#rfc.authors">Authors' Addresses</a>
</li>
</ul>
<h1 id="rfc.section.1"><a href="#rfc.section.1">1.</a> <a href="#introduction" id="introduction">Introduction</a></h1>
<h1 id="rfc.section.1">
<a href="#rfc.section.1">1.</a> <a href="#introduction" id="introduction">Introduction</a>
</h1>
<p id="rfc.section.1.p.1">In 2011, Zed A. Shaw published a blog post which describes: </p>
<p id="rfc.section.1.p.2">I think I'm going to create the ultimate software development methodology. It'll be revolutionary compared to others because it will focus on the one thing that gets software done. Its entire focus will be this one, glorious, completely useful activity for writing software. It's name even embodies the perfection of this programming methodology. </p>
<p id="rfc.section.1.p.3">The programming methodology was published as a manifesto later <a href="#PROGRAMMING-MF-MANIFESTO">[PROGRAMMING-MF-MANIFESTO]</a>. The manifesto clearly describes the focus on programming to avoid the surrounding management overhead and pivot towards the delivery of the software. The <a href="#THE-TAO-OF-PROGRAMMING">[THE-TAO-OF-PROGRAMMING]</a> describes similar methodologies which strongly focus on coding, scripting and programming. </p>
<p id="rfc.section.1.p.3">The PMF methodology was published as a manifesto later <a href="#PROGRAMMING-MF-MANIFESTO" class="xref">[PROGRAMMING-MF-MANIFESTO]</a>. The manifesto clearly describes the focus on programming to avoid the surrounding management overhead and pivot towards the delivery of the software. The <a href="#THE-TAO-OF-PROGRAMMING" class="xref">[THE-TAO-OF-PROGRAMMING]</a> describes similar methodologies which strongly focus on coding, scripting and programming. </p>
<p id="rfc.section.1.p.4">The overall concept of PMF methodology follows the following process: </p>
<p/>
<p></p>
<ul>
<li>Compose a list of features to be implemented and use an iterative programming process.</li>
@ -497,9 +502,11 @@
| |
+----------+
</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>
<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/>
<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 requirement 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>
<ul>
<li>Collect requirements of the users/customers.</li>
@ -508,44 +515,42 @@
</ul>
<p> </p>
<h1 id="rfc.section.1.2"><a href="#rfc.section.1.2">1.2.</a> <a href="#conventions-and-terminology" id="conventions-and-terminology">Conventions and Terminology</a></h1>
<p id="rfc.section.1.2.p.1">The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 <a href="#RFC2119">[RFC2119]</a>. </p>
<h1 id="rfc.section.2"><a href="#rfc.section.2">2.</a> <a href="#security-considerations" id="security-considerations">Security Considerations</a></h1>
<p id="rfc.section.2.p.1">Secure and defensive programming can only come by practicing programming and this also includes the act of simplifying or removing code to reduce the attack surface. </p>
<h1 id="rfc.section.3"><a href="#rfc.section.3">3.</a> <a href="#acknowledgements" id="acknowledgements">Acknowledgements</a></h1>
<p id="rfc.section.3.p.1">The authors wish to thank all the programmers who program. </p>
<h1 id="rfc.references"><a href="#rfc.references">4.</a> References</h1>
<h1 id="rfc.references.1"><a href="#rfc.references.1">4.1.</a> Normative References</h1>
<table>
<tbody>
<tr>
<td class="reference">
<b id="RFC2119">[RFC2119]</b>
</td>
<td class="top"><a>Bradner, S.</a>, "<a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997.</td>
</tr>
</tbody>
</table>
<h1 id="rfc.references.2"><a href="#rfc.references.2">4.2.</a> Informative References</h1>
<table>
<tbody>
<tr>
<td class="reference">
<b id="PROGRAMMING-MF-MANIFESTO">[PROGRAMMING-MF-MANIFESTO]</b>
</td>
<td class="top"><a>Shaw, </a>, "<a href="http://programming-motherfucker.com">Programming Motherfucker, do you speak it?</a>"</td>
</tr>
<tr>
<td class="reference">
<b id="THE-TAO-OF-PROGRAMMING">[THE-TAO-OF-PROGRAMMING]</b>
</td>
<td class="top"><a>James, </a>, "<a href="http://www.mit.edu/~xela/tao.html">The Tao of Programming</a>"</td>
</tr>
</tbody>
</table>
<h1 id="rfc.authors">
<a href="#rfc.authors">Authors' Addresses</a>
<h1 id="rfc.section.1.2">
<a href="#rfc.section.1.2">1.2.</a> <a href="#conventions-and-terminology" id="conventions-and-terminology">Conventions and Terminology</a>
</h1>
<p id="rfc.section.1.2.p.1">The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 <a href="#RFC2119" class="xref">[RFC2119]</a>. </p>
<h1 id="rfc.section.2">
<a href="#rfc.section.2">2.</a> <a href="#security-considerations" id="security-considerations">Security Considerations</a>
</h1>
<p id="rfc.section.2.p.1">Secure and defensive programming can only come by practicing programming and this also includes the act of simplifying or removing code to reduce the attack surface. </p>
<h1 id="rfc.section.3">
<a href="#rfc.section.3">3.</a> <a href="#acknowledgements" id="acknowledgements">Acknowledgements</a>
</h1>
<p id="rfc.section.3.p.1">The authors wish to thank all the programmers who program. </p>
<h1 id="rfc.references">
<a href="#rfc.references">4.</a> References</h1>
<h1 id="rfc.references.1">
<a href="#rfc.references.1">4.1.</a> Normative References</h1>
<table><tbody><tr>
<td class="reference"><b id="RFC2119">[RFC2119]</b></td>
<td class="top">
<a>Bradner, S.</a>, "<a href="https://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997.</td>
</tr></tbody></table>
<h1 id="rfc.references.2">
<a href="#rfc.references.2">4.2.</a> Informative References</h1>
<table><tbody>
<tr>
<td class="reference"><b id="PROGRAMMING-MF-MANIFESTO">[PROGRAMMING-MF-MANIFESTO]</b></td>
<td class="top">
<a>Shaw</a>, "<a href="http://programming-motherfucker.com">Programming Motherfucker, do you speak it?</a>"</td>
</tr>
<tr>
<td class="reference"><b id="THE-TAO-OF-PROGRAMMING">[THE-TAO-OF-PROGRAMMING]</b></td>
<td class="top">
<a>James</a>, "<a href="http://www.mit.edu/~xela/tao.html">The Tao of Programming</a>"</td>
</tr>
</tbody></table>
<h1 id="rfc.authors"><a href="#rfc.authors">Authors' Addresses</a></h1>
<div class="avoidbreak">
<address class="vcard">
<span class="vcardline">

View file

@ -5,7 +5,7 @@
Network Working Group A. Dulaunoy
Internet-Draft A. Iklody
Intended status: Informational CIRCL
Expires: April 18, 2018 October 15, 2017
Expires: October 13, 2019 April 11, 2019
Programming Methodology Framework aka PMF
@ -17,7 +17,7 @@ Abstract
known under the PMF methodology. The methodology is based on the
manifesto written by Zed A. Shaw [PROGRAMMING-MF-MANIFESTO] which
describes a natural approach to software engineering with a strong
focus on the act of programming. The PM methodology uses a soft
focus on the act of programming. The PMF methodology uses a soft
naming to allow for a non-partisan reference to official engineering
or project documents describing one of the most used software
engineering methodologies.
@ -30,32 +30,32 @@ Status of This Memo
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/.
Drafts is at https://datatracker.ietf.org/drafts/current/.
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."
This Internet-Draft will expire on April 18, 2018.
This Internet-Draft will expire on October 13, 2019.
Copyright Notice
Copyright (c) 2017 IETF Trust and the persons identified as the
Copyright (c) 2019 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of
(https://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must
Dulaunoy & Iklody Expires April 18, 2018 [Page 1]
Dulaunoy & Iklody Expires October 13, 2019 [Page 1]
Internet-Draft PMF - Programming Methodology Framework October 2017
Internet-Draft PMF - Programming Methodology Framework April 2019
include Simplified BSD License text as described in Section 4.e of
@ -85,7 +85,7 @@ Table of Contents
writing software. It's name even embodies the perfection of this
programming methodology.
The programming methodology was published as a manifesto later
The PMF methodology was published as a manifesto later
[PROGRAMMING-MF-MANIFESTO]. The manifesto clearly describes the
focus on programming to avoid the surrounding management overhead and
pivot towards the delivery of the software. The
@ -109,9 +109,9 @@ Table of Contents
Dulaunoy & Iklody Expires April 18, 2018 [Page 2]
Dulaunoy & Iklody Expires October 13, 2019 [Page 2]
Internet-Draft PMF - Programming Methodology Framework October 2017
Internet-Draft PMF - Programming Methodology Framework April 2019
+----------+
@ -136,7 +136,7 @@ Internet-Draft PMF - Programming Methodology Framework October 2017
1.1. Management and PMF methodology
A simple management process is a required of the PMF methodology.
A simple management process is a requirement 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.
@ -165,9 +165,9 @@ Internet-Draft PMF - Programming Methodology Framework October 2017
Dulaunoy & Iklody Expires April 18, 2018 [Page 3]
Dulaunoy & Iklody Expires October 13, 2019 [Page 3]
Internet-Draft PMF - Programming Methodology Framework October 2017
Internet-Draft PMF - Programming Methodology Framework April 2019
3. Acknowledgements
@ -180,17 +180,17 @@ Internet-Draft PMF - Programming Methodology Framework October 2017
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997, <https://www.rfc-
editor.org/info/rfc2119>.
DOI 10.17487/RFC2119, March 1997,
<https://www.rfc-editor.org/info/rfc2119>.
4.2. Informative References
[PROGRAMMING-MF-MANIFESTO]
Shaw, , "Programming Motherfucker, do you speak it?",
Shaw, "Programming Motherfucker, do you speak it?",
<http://programming-motherfucker.com>.
[THE-TAO-OF-PROGRAMMING]
James, , "The Tao of Programming",
James, "The Tao of Programming",
<http://www.mit.edu/~xela/tao.html>.
Authors' Addresses
@ -221,4 +221,4 @@ Authors' Addresses
Dulaunoy & Iklody Expires April 18, 2018 [Page 4]
Dulaunoy & Iklody Expires October 13, 2019 [Page 4]

View file

@ -42,7 +42,7 @@
<uri></uri>
</address>
</author>
<date year="2017" month="October" day="15"/>
<date year="2019" month="April" day="11"/>
<area>Internet</area>
<workgroup></workgroup>
@ -54,7 +54,7 @@
<abstract>
<t>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 <xref target="PROGRAMMING-MF-MANIFESTO"/> which
describes a natural approach to software engineering with a strong focus on the act of programming. The PM methodology uses a soft naming to allow for a non-partisan reference
describes a natural approach to software engineering with a strong focus on the act of programming. The PMF methodology uses a soft naming to allow for a non-partisan reference
to official engineering or project documents describing one of the most used software engineering methodologies.
</t>
</abstract>
@ -69,7 +69,7 @@ to official engineering or project documents describing one of the most used sof
</t>
<t>I think I'm going to create the ultimate software development methodology. It'll be revolutionary compared to others because it will focus on the one thing that gets software done. Its entire focus will be this one, glorious, completely useful activity for writing software. It's name even embodies the perfection of this programming methodology.
</t>
<t>The programming methodology was published as a manifesto later <xref target="PROGRAMMING-MF-MANIFESTO"/>. The manifesto clearly describes the focus on programming to avoid the surrounding management overhead and pivot towards the delivery of the software. The <xref target="THE-TAO-OF-PROGRAMMING"/> describes similar methodologies which strongly focus on coding, scripting and programming.
<t>The PMF methodology was published as a manifesto later <xref target="PROGRAMMING-MF-MANIFESTO"/>. The manifesto clearly describes the focus on programming to avoid the surrounding management overhead and pivot towards the delivery of the software. The <xref target="THE-TAO-OF-PROGRAMMING"/> describes similar methodologies which strongly focus on coding, scripting and programming.
</t>
<t>The overall concept of PMF methodology follows the following process:
</t>
@ -108,7 +108,7 @@ to official engineering or project documents describing one of the most used sof
</artwork></figure>
<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 requirement 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.
</t>