mirror of
https://github.com/adulau/pmf.git
synced 2024-11-24 19:17:12 +00:00
1232 lines
35 KiB
HTML
1232 lines
35 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="en" class="Internet-Draft">
|
||
<head>
|
||
<meta charset="utf-8">
|
||
<meta name="scripts" content="Common,Latin">
|
||
<title>Programming Methodology Framework aka PMF</title>
|
||
<meta name="author" content="Alexandre Dulaunoy">
|
||
<meta name="author" content="Andras Iklody">
|
||
<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 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.
|
||
">
|
||
<meta name="generator" content="xml2rfc 2.23.1">
|
||
<meta name="keyword" content="software engineering">
|
||
<meta name="keyword" content="engineering">
|
||
<meta name="keyword" content="pmf">
|
||
<meta name="keyword" content="programming">
|
||
<link rel="alternate" type="application/rfc+xml" href="raw.md.xml">
|
||
<link rel="license" href="#copyright">
|
||
<style type="text/css">/* fonts */
|
||
@import url('https://fonts.googleapis.com/css?family=Noto+Sans'); /* Sans-serif */
|
||
@import url('https://fonts.googleapis.com/css?family=Noto+Serif'); /* Serif (print) */
|
||
@import url('https://fonts.googleapis.com/css?family=Roboto+Mono'); /* Monospace */
|
||
|
||
@-ms-viewport {
|
||
width: extend-to-zoom;
|
||
zoom: 1.0;
|
||
}
|
||
/* general and mobile first */
|
||
html {
|
||
}
|
||
body {
|
||
max-width: 90%;
|
||
margin: 1.5em auto;
|
||
color: #222;
|
||
background-color: #fff;
|
||
font-size: 14px;
|
||
font-family: 'Noto Sans', Arial, Helvetica, sans-serif;
|
||
line-height: 1.6;
|
||
scroll-behavior: smooth;
|
||
}
|
||
.ears {
|
||
display: none;
|
||
}
|
||
|
||
/* headings */
|
||
#title, h1, h2, h3, h4, h5, h6 {
|
||
margin: 1em 0 0.5em;
|
||
font-weight: bold;
|
||
line-height: 1.3;
|
||
}
|
||
#title {
|
||
clear: both;
|
||
border-bottom: 1px solid #ddd;
|
||
margin: 0 0 0.5em 0;
|
||
padding: 1em 0 0.5em;
|
||
}
|
||
.author {
|
||
padding-bottom: 4px;
|
||
}
|
||
h1 {
|
||
font-size: 26px;
|
||
margin: 1em 0;
|
||
}
|
||
h2 {
|
||
font-size: 22px;
|
||
margin-top: -20px; /* provide offset for in-page anchors */
|
||
padding-top: 33px;
|
||
}
|
||
h3 {
|
||
font-size: 18px;
|
||
margin-top: -36px; /* provide offset for in-page anchors */
|
||
padding-top: 42px;
|
||
}
|
||
h4 {
|
||
font-size: 16px;
|
||
margin-top: -36px; /* provide offset for in-page anchors */
|
||
padding-top: 42px;
|
||
}
|
||
h5, h6 {
|
||
font-size: 14px;
|
||
}
|
||
#n-copyright-notice {
|
||
border-bottom: 1px solid #ddd;
|
||
padding-bottom: 1em;
|
||
margin-bottom: 1em;
|
||
}
|
||
/* general structure */
|
||
p {
|
||
padding: 0;
|
||
margin: 0 0 1em 0;
|
||
text-align: left;
|
||
}
|
||
div, span {
|
||
position: relative;
|
||
}
|
||
div {
|
||
margin: 0;
|
||
}
|
||
.alignRight.art-text {
|
||
background-color: #f9f9f9;
|
||
border: 1px solid #eee;
|
||
border-radius: 3px;
|
||
padding: 1em 1em 0;
|
||
margin-bottom: 1.5em;
|
||
}
|
||
.alignRight.art-text pre {
|
||
padding: 0;
|
||
}
|
||
.alignRight {
|
||
margin: 1em 0;
|
||
}
|
||
.alignRight > *:first-child {
|
||
border: none;
|
||
margin: 0;
|
||
float: right;
|
||
clear: both;
|
||
}
|
||
.alignRight > *:nth-child(2) {
|
||
clear: both;
|
||
display: block;
|
||
border: none;
|
||
}
|
||
svg {
|
||
display: block;
|
||
}
|
||
.alignCenter.art-text {
|
||
background-color: #f9f9f9;
|
||
border: 1px solid #eee;
|
||
border-radius: 3px;
|
||
padding: 1em 1em 0;
|
||
margin-bottom: 1.5em;
|
||
}
|
||
.alignCenter.art-text pre {
|
||
padding: 0;
|
||
}
|
||
.alignCenter {
|
||
margin: 1em 0;
|
||
}
|
||
.alignCenter > *:first-child {
|
||
border: none;
|
||
/* this isn't optimal, but it's an existence proof. PrinceXML doesn't
|
||
support flexbox yet.
|
||
*/
|
||
display: table;
|
||
margin: 0 auto;
|
||
}
|
||
|
||
/* lists */
|
||
ol, ul {
|
||
padding: 0;
|
||
margin: 0 0 1em 2em;
|
||
}
|
||
ol ol, ul ul, ol ul, ul ol {
|
||
margin-left: 1em;
|
||
}
|
||
li {
|
||
margin: 0 0 0.25em 0;
|
||
}
|
||
.ulCompact li {
|
||
margin: 0;
|
||
}
|
||
ul.empty, .ulEmpty {
|
||
list-style-type: none;
|
||
}
|
||
ul.empty li, .ulEmpty li {
|
||
margin-top: 0.5em;
|
||
}
|
||
ul.compact, .ulCompact,
|
||
ol.compact, .olCompact {
|
||
line-height: 100%;
|
||
margin: 0 0 0 2em;
|
||
}
|
||
|
||
/* definition lists */
|
||
dl {
|
||
}
|
||
dl > dt {
|
||
float: left;
|
||
margin-right: 1em;
|
||
}
|
||
dl > dd {
|
||
margin-bottom: .8em;
|
||
min-height: 1.3em;
|
||
}
|
||
dl.compact > dd, dlCompact > dd {
|
||
margin-bottom: 0em;
|
||
}
|
||
dl > dd > dl {
|
||
margin-top: 0.5em;
|
||
margin-bottom: 0em;
|
||
}
|
||
|
||
/* links */
|
||
a {
|
||
text-decoration: none;
|
||
z-index: 2;
|
||
}
|
||
a[href] {
|
||
color: #3E8EDE;
|
||
}
|
||
a[href]:hover {
|
||
background-color: #f2f2f2;
|
||
}
|
||
figcaption a[href],
|
||
a[href].selfRef {
|
||
color: #222;
|
||
}
|
||
/* XXX probably not this:
|
||
a.selfRef:hover {
|
||
background-color: transparent;
|
||
cursor: default;
|
||
} */
|
||
|
||
/* Figures */
|
||
tt, code, pre, code {
|
||
background-color: #f9f9f9;
|
||
font-family: 'Roboto Mono', monospace;
|
||
}
|
||
pre {
|
||
border: 1px solid #eee;
|
||
margin: 0;
|
||
padding: 1em;
|
||
}
|
||
img {
|
||
max-width: 100%;
|
||
}
|
||
figure {
|
||
margin: 0;
|
||
}
|
||
figure blockquote {
|
||
margin: 0.8em 0.4em 0.4em;
|
||
}
|
||
figcaption {
|
||
font-style: italic;
|
||
margin: 0 0 1em 0;
|
||
}
|
||
@media screen {
|
||
pre {
|
||
overflow-x: auto;
|
||
max-width: 100%;
|
||
max-width: calc(100% - 22px);
|
||
}
|
||
}
|
||
|
||
/* aside, blockquote */
|
||
aside, blockquote {
|
||
margin-left: 0;
|
||
padding: 1.2em 2em;
|
||
}
|
||
blockquote {
|
||
background-color: #f9f9f9;
|
||
border: 1px solid #ddd;
|
||
border-radius: 3px;
|
||
margin: 1em 0;
|
||
}
|
||
cite {
|
||
display: block;
|
||
text-align: right;
|
||
font-style: italic;
|
||
}
|
||
|
||
/* tables */
|
||
table {
|
||
width: 100%;
|
||
margin: 0 0 1em;
|
||
border-collapse: collapse;
|
||
border: 1px solid #eee;
|
||
}
|
||
th, td {
|
||
text-align: left;
|
||
vertical-align: top;
|
||
padding: 0.5em 0.75em;
|
||
}
|
||
th {
|
||
text-align: left;
|
||
background-color: #e9e9e9;
|
||
}
|
||
tr:nth-child(2n+1) > td {
|
||
background-color: #f5f5f5;
|
||
}
|
||
table caption {
|
||
font-style: italic;
|
||
margin: 0;
|
||
padding: 0;
|
||
text-align: left;
|
||
}
|
||
table p {
|
||
/* XXX to avoid bottom margin on table row signifiers. If paragraphs should
|
||
be allowed within tables more generally, it would be far better to select on a class. */
|
||
margin: 0;
|
||
}
|
||
|
||
/* pilcrow */
|
||
a.pilcrow {
|
||
color: #777;
|
||
text-decoration: none;
|
||
visibility: hidden;
|
||
user-select: none;
|
||
-ms-user-select: none;
|
||
-o-user-select:none;
|
||
-moz-user-select: none;
|
||
-khtml-user-select: none;
|
||
-webkit-user-select: none;
|
||
-webkit-touch-callout: none;
|
||
}
|
||
@media screen {
|
||
aside:hover > a.pilcrow,
|
||
p:hover > a.pilcrow,
|
||
blockquote:hover > a.pilcrow,
|
||
div:hover > a.pilcrow,
|
||
li:hover > a.pilcrow,
|
||
pre:hover > a.pilcrow {
|
||
visibility: visible;
|
||
}
|
||
a.pilcrow:hover {
|
||
background-color: transparent;
|
||
}
|
||
}
|
||
|
||
/* misc */
|
||
hr {
|
||
border: 0;
|
||
border-top: 1px solid #eee;
|
||
}
|
||
.bcp14 {
|
||
font-variant: small-caps;
|
||
}
|
||
|
||
.role {
|
||
font-variant: all-small-caps;
|
||
}
|
||
|
||
/* info block */
|
||
#identifiers {
|
||
margin: 0;
|
||
font-size: 0.9em;
|
||
}
|
||
#identifiers dt {
|
||
width: 3em;
|
||
clear: left;
|
||
}
|
||
#identifiers dd {
|
||
float: left;
|
||
margin-bottom: 0;
|
||
}
|
||
#identifiers .authors .author {
|
||
display: inline-block;
|
||
margin-right: 1.5em;
|
||
}
|
||
#identifiers .authors .org {
|
||
font-style: italic;
|
||
}
|
||
|
||
/* The prepared/rendered info at the very bottom of the page */
|
||
.docInfo {
|
||
color: #999;
|
||
font-size: 0.9em;
|
||
font-style: italic;
|
||
margin-top: 2em;
|
||
}
|
||
.docInfo .prepared {
|
||
float: left;
|
||
}
|
||
.docInfo .prepared {
|
||
float: right;
|
||
}
|
||
|
||
/* table of contents */
|
||
#toc {
|
||
padding: 0.75em 0 2em 0;
|
||
margin-bottom: 1em;
|
||
}
|
||
nav.toc ul {
|
||
margin: 0 0.5em 0 0;
|
||
padding: 0;
|
||
list-style: none;
|
||
}
|
||
nav.toc li {
|
||
line-height: 1.3em;
|
||
margin: 0.75em 0;
|
||
padding-left: 1.2em;
|
||
text-indent: -1.2em;
|
||
}
|
||
/* references */
|
||
.references dt {
|
||
text-align: right;
|
||
font-weight: bold;
|
||
min-width: 7em;
|
||
}
|
||
.references dd {
|
||
margin-left: 8em;
|
||
overflow: auto;
|
||
}
|
||
|
||
.refInstance {
|
||
margin-bottom: 1.25em;
|
||
}
|
||
|
||
.references .ascii {
|
||
margin-bottom: 0.25em;
|
||
}
|
||
|
||
/* index */
|
||
.index ul {
|
||
margin: 0 0 0 1em;
|
||
padding: 0;
|
||
list-style: none;
|
||
}
|
||
.index ul ul {
|
||
margin: 0;
|
||
}
|
||
.index li {
|
||
margin: 0;
|
||
text-indent: -2em;
|
||
padding-left: 2em;
|
||
padding-bottom: 5px;
|
||
}
|
||
.indexIndex {
|
||
margin: 0.5em 0 1em;
|
||
}
|
||
.index a {
|
||
font-weight: 700;
|
||
}
|
||
/* make the index two-column on all but the smallest screens */
|
||
@media (min-width: 600px) {
|
||
.index ul {
|
||
-moz-column-count: 2;
|
||
-moz-column-gap: 20px;
|
||
}
|
||
.index ul ul {
|
||
-moz-column-count: 1;
|
||
-moz-column-gap: 0;
|
||
}
|
||
}
|
||
|
||
/* authors */
|
||
address.vcard {
|
||
font-style: normal;
|
||
margin: 1em 0;
|
||
}
|
||
|
||
address.vcard .nameRole {
|
||
font-weight: 700;
|
||
margin-left: 0;
|
||
}
|
||
address.vcard .label {
|
||
font-family: "Noto Sans",Arial,Helvetica,sans-serif;
|
||
margin: 0.5em 0;
|
||
}
|
||
address.vcard .type {
|
||
display: none;
|
||
}
|
||
.alternative-contact {
|
||
margin: 1.5em 0 1em;
|
||
}
|
||
hr.addr {
|
||
border-top: 1px dashed;
|
||
margin: 0;
|
||
color: #ddd;
|
||
max-width: calc(100% - 16px);
|
||
}
|
||
|
||
/* temporary notes */
|
||
.rfcEditorRemove::before {
|
||
position: absolute;
|
||
top: 0.2em;
|
||
right: 0.2em;
|
||
padding: 0.2em;
|
||
content: "The RFC Editor will remove this note";
|
||
color: #b76427;
|
||
background-color: rgba(249, 232, 105, 0.3);
|
||
}
|
||
.rfcEditorRemove {
|
||
position: relative;
|
||
padding-top: 1.8em;
|
||
background-color: rgba(249, 232, 105, 0.3);
|
||
border-radius: 3px;
|
||
}
|
||
.cref {
|
||
background-color: rgba(249, 232, 105, 0.3);
|
||
padding: 2px 4px;
|
||
}
|
||
.crefSource {
|
||
font-style: italic;
|
||
}
|
||
/* alternative layout for smaller screens */
|
||
@media screen and (max-width: 1023px) {
|
||
body {
|
||
padding-top: 2em;
|
||
}
|
||
#title {
|
||
padding: 1em 0;
|
||
}
|
||
h1 {
|
||
font-size: 24px;
|
||
}
|
||
h2 {
|
||
font-size: 20px;
|
||
margin-top: -18px; /* provide offset for in-page anchors */
|
||
padding-top: 38px;
|
||
}
|
||
#identifiers dd {
|
||
max-width: 60%;
|
||
}
|
||
#toc {
|
||
position: fixed;
|
||
z-index: 2;
|
||
top: 0;
|
||
right: 0;
|
||
padding: 0;
|
||
margin: 0;
|
||
background-color: inherit;
|
||
border-bottom: 1px solid #ccc;
|
||
}
|
||
#toc h2 {
|
||
margin: -1px 0 0 0;
|
||
padding: 4px 0 4px 6px;
|
||
padding-right: 1em;
|
||
min-width: 190px;
|
||
font-size: 1.1em;
|
||
text-align: right;
|
||
background-color: #444;
|
||
color: white;
|
||
cursor: pointer;
|
||
}
|
||
#toc h2::before { /* css hamburger */
|
||
float: right;
|
||
position: relative;
|
||
width: 1em;
|
||
height: 1px;
|
||
left: -164px;
|
||
margin: 6px 0 0 0;
|
||
background: white none repeat scroll 0 0;
|
||
box-shadow: 0 4px 0 0 white, 0 8px 0 0 white;
|
||
content: "";
|
||
}
|
||
#toc nav {
|
||
display: none;
|
||
padding: 0.5em 1em 1em;
|
||
overflow: auto;
|
||
height: calc(100vh - 48px);
|
||
border-left: 1px solid #ddd;
|
||
}
|
||
}
|
||
|
||
/* alternative layout for wide screens */
|
||
@media screen and (min-width: 1024px) {
|
||
body {
|
||
max-width: 724px;
|
||
margin: 42px auto;
|
||
padding-left: 1.5em;
|
||
padding-right: 29em;
|
||
}
|
||
#toc {
|
||
position: fixed;
|
||
top: 42px;
|
||
right: 42px;
|
||
width: 25%;
|
||
margin: 0;
|
||
padding: 0 1em;
|
||
z-index: 1;
|
||
}
|
||
#toc h2 {
|
||
border-top: none;
|
||
border-bottom: 1px solid #ddd;
|
||
font-size: 1em;
|
||
font-weight: normal;
|
||
margin: 0;
|
||
padding: 0.25em 1em 1em 0;
|
||
}
|
||
#toc nav {
|
||
display: block;
|
||
height: calc(90vh - 84px);
|
||
bottom: 0;
|
||
padding: 0.5em 0 0;
|
||
overflow: auto;
|
||
}
|
||
img { /* future proofing */
|
||
max-width: 100%;
|
||
height: auto;
|
||
}
|
||
}
|
||
|
||
/* pagination */
|
||
@media print {
|
||
body {
|
||
|
||
width: 100%;
|
||
}
|
||
p {
|
||
orphans: 3;
|
||
widows: 3;
|
||
}
|
||
#n-copyright-notice {
|
||
border-bottom: none;
|
||
}
|
||
#toc, #n-introduction {
|
||
page-break-before: always;
|
||
}
|
||
#toc {
|
||
border-top: none;
|
||
padding-top: 0;
|
||
}
|
||
figure, pre {
|
||
page-break-inside: avoid;
|
||
}
|
||
figure {
|
||
overflow: scroll;
|
||
}
|
||
h1, h2, h3, h4, h5, h6 {
|
||
page-break-after: avoid;
|
||
}
|
||
h2+*, h3+*, h4+*, h5+*, h6+* {
|
||
page-break-before: avoid;
|
||
}
|
||
pre {
|
||
white-space: pre-wrap;
|
||
word-wrap: break-word;
|
||
font-size: 10pt;
|
||
}
|
||
table {
|
||
border: 1px solid #ddd;
|
||
}
|
||
td {
|
||
border-top: 1px solid #ddd;
|
||
}
|
||
}
|
||
|
||
@page :first {
|
||
padding-top: 0;
|
||
@top-left {
|
||
content: normal;
|
||
border: none;
|
||
}
|
||
@top-center {
|
||
content: normal;
|
||
border: none;
|
||
}
|
||
@top-right {
|
||
content: normal;
|
||
border: none;
|
||
}
|
||
}
|
||
|
||
@page {
|
||
size: A4;
|
||
margin-bottom: 45mm;
|
||
padding-top: 20px;
|
||
}
|
||
|
||
/* Changes introduced to fix issues found during implementation */
|
||
|
||
/* Separate body from document info even without intervening H1 */
|
||
section {
|
||
clear: both;
|
||
}
|
||
|
||
|
||
/* Top align author divs, to avoid names without organization dropping level with org names */
|
||
.author {
|
||
vertical-align: top;
|
||
}
|
||
|
||
/* Leave room in document info to show Internet-Draft on one line */
|
||
#identifiers dt {
|
||
width: 8em;
|
||
}
|
||
|
||
/* Don't waste quite as much whitespace between label and value in doc info */
|
||
#identifiers dd {
|
||
margin-left: 1em;
|
||
}
|
||
|
||
/* Give floating toc a background color (needed when it's a div inside section */
|
||
#toc {
|
||
background-color: white;
|
||
}
|
||
|
||
/* Make the collapsed ToC header render white on gray also when it's a link */
|
||
@media screen and (max-width: 1023px) {
|
||
#toc h2 a,
|
||
#toc h2 a:link,
|
||
#toc h2 a:focus,
|
||
#toc h2 a:hover,
|
||
#toc a.toplink,
|
||
#toc a.toplink:hover {
|
||
color: white;
|
||
background-color: #444;
|
||
text-decoration: none;
|
||
}
|
||
}
|
||
|
||
/* Give the bottom of the ToC some whitespace */
|
||
@media screen and (min-width: 1024px) {
|
||
#toc {
|
||
padding: 0 0 1em 1em;
|
||
}
|
||
}
|
||
|
||
/* Style section numbers with more space between number and title */
|
||
.section-number {
|
||
padding-right: 0.5em;
|
||
}
|
||
|
||
/* prevent monospace from becoming overly large */
|
||
tt, code, pre, code {
|
||
font-size: 95%;
|
||
}
|
||
|
||
/* Fix the height/width aspect for ascii art*/
|
||
.art-text pre {
|
||
line-height: 1.12;
|
||
}
|
||
|
||
/* Add styling for a link in the ToC that points to the top of the document */
|
||
a.toplink {
|
||
float: right;
|
||
margin-right: 0.5em;
|
||
}
|
||
|
||
/* Fix the dl styling to match the RFC 7992 attributes */
|
||
dl > dt,
|
||
dl.dlParallel > dt {
|
||
float: left;
|
||
margin-right: 1em;
|
||
}
|
||
dl.dlNewline > dt {
|
||
float: none;
|
||
}
|
||
|
||
/* Provide styling for table cell text alignment */
|
||
table td.text-left,
|
||
table th.text-left {
|
||
text-align: left;
|
||
}
|
||
table td.text-center,
|
||
table th.text-center {
|
||
text-align: center;
|
||
}
|
||
table td.text-right,
|
||
table th.text-right {
|
||
text-align: right;
|
||
}
|
||
|
||
/* Make the alternative author contact informatio look less like just another
|
||
author, and group it closer with the primary author contact information */
|
||
.alternative-contact {
|
||
margin: 0.5em 0 0.25em 0;
|
||
}
|
||
address .non-ascii {
|
||
margin: 0 0 0 2em;
|
||
}
|
||
|
||
/* With it being possible to set tables with alignment
|
||
left, center, and right, { width: 100%; } does not make sense */
|
||
table {
|
||
width: auto;
|
||
}
|
||
|
||
/* Avoid reference text that sits in a block with very wide left margin,
|
||
because of a long floating dt label.*/
|
||
.references dd {
|
||
overflow: visible;
|
||
}
|
||
|
||
/* Control caption placement */
|
||
caption {
|
||
caption-side: bottom;
|
||
}
|
||
|
||
/* Limit the width of the author address vcard, so names in right-to-left
|
||
script don't end up on the other side of the page. */
|
||
|
||
address.vcard {
|
||
max-width: 20em;
|
||
margin-right: auto;
|
||
}
|
||
|
||
/* For address alignment dependent on LTR or RTL scripts */
|
||
address div.left {
|
||
text-align: left;
|
||
}
|
||
address div.right {
|
||
text-align: right;
|
||
}
|
||
|
||
/* Provide table alignment support. We can't use the alignX classes above
|
||
since they do unwanted things with caption and other styling. */
|
||
table.right {
|
||
margin-left: auto;
|
||
margin-right: 0;
|
||
}
|
||
table.center {
|
||
margin-left: auto;
|
||
margin-right: auto;
|
||
}
|
||
table.left {
|
||
margin-left: 0;
|
||
margin-right: auto;
|
||
}
|
||
|
||
/* Give the table caption label the same styling as the figcaption */
|
||
caption a[href] {
|
||
color: #222;
|
||
}
|
||
|
||
@media print {
|
||
.toplink {
|
||
display: none;
|
||
}
|
||
|
||
/* avoid overwriting the top border line with the ToC header */
|
||
#toc {
|
||
padding-top: 1px;
|
||
}
|
||
|
||
/* Avoid page breaks inside dl and author address entries */
|
||
dd {
|
||
page-break-before: avoid;
|
||
}
|
||
.vcard {
|
||
page-break-inside: avoid;
|
||
}
|
||
|
||
}
|
||
/* Avoid wrapping of URLs in references */
|
||
.references a {
|
||
white-space: nowrap;
|
||
}
|
||
/* Tweak the bcp14 keyword presentation */
|
||
.bcp14 {
|
||
font-variant: small-caps;
|
||
font-weight: bold;
|
||
font-size: 0.9em;
|
||
}
|
||
/* Tweak the invisible space above H* in order not to overlay links in text above */
|
||
h2 {
|
||
margin-top: -18px; /* provide offset for in-page anchors */
|
||
padding-top: 31px;
|
||
}
|
||
h3 {
|
||
margin-top: -18px; /* provide offset for in-page anchors */
|
||
padding-top: 24px;
|
||
}
|
||
h4 {
|
||
margin-top: -18px; /* provide offset for in-page anchors */
|
||
padding-top: 24px;
|
||
}
|
||
</style>
|
||
<link rel="stylesheet" href="rfc-local.css" type="text/css">
|
||
</head>
|
||
<body>
|
||
<script>
|
||
window.addEventListener('load',addMetadata);
|
||
|
||
async function addMetadata() {
|
||
|
||
// Copy all CSS rules for "#identifiers" to "#metadata"
|
||
try {
|
||
const cssRules = document.styleSheets[0].cssRules;
|
||
for (let i = 0; i < cssRules.length; i++) {
|
||
if (/#identifiers/.exec(cssRules[i].selectorText)) {
|
||
const rule = cssRules[i].cssText.
|
||
replace('#identifiers','#metadata');
|
||
document.styleSheets[0].
|
||
insertRule(rule, document.styleSheets[0].cssRules.length);
|
||
}
|
||
}
|
||
} catch (e) {
|
||
console.log(e);
|
||
}
|
||
|
||
// Retrieve the "metadata" element from the document
|
||
const div = document.getElementById('metadata');
|
||
if (!div) {
|
||
console.log("Could not locate metadata <div> element");
|
||
return;
|
||
}
|
||
div.style.background='#eee';
|
||
|
||
// Insert the metadata block
|
||
// [TODO: make this more sophisticated and linkify the values]
|
||
try {
|
||
const jsonFile = document.URL.replace(/html$/,'json');
|
||
const response = await fetch(jsonFile);
|
||
const metadata = (await response.json())[0];
|
||
|
||
const label = {
|
||
'STATUS': 'Status',
|
||
'OBSOLETES': 'Obsoletes',
|
||
'OBSOLETED-BY': 'Obsoleted By',
|
||
'UPDATES': 'Updates',
|
||
'UPDATED-BY': 'Updated By',
|
||
'SEE-ALSO': 'See Also',
|
||
'ERRATA-URL': 'Errata',
|
||
};
|
||
|
||
let metadataHTML = "<dl style='overflow:hidden'>";
|
||
['STATUS', 'OBSOLETES', 'OBSOLETED-BY', 'UPDATES',
|
||
'UPDATED-BY', 'SEE-ALSO', 'ERRATA-URL'].forEach(key => {
|
||
if (metadata[key]) {
|
||
metadataHTML += `<dt>${label[key]}:</dt><dd>${metadata[key]}</dd>`;
|
||
}
|
||
})
|
||
metadataHTML += "</dl>";
|
||
div.innerHTML = metadataHTML;
|
||
|
||
} catch (e) {
|
||
console.log(e);
|
||
}
|
||
}
|
||
</script>
|
||
<table class="ears">
|
||
<thead><tr>
|
||
<td class="left">Internet-Draft</td>
|
||
<td class="center">PMF - Programming Methodology Framework</td>
|
||
<td class="right">October 2021</td>
|
||
</tr></thead>
|
||
<tfoot><tr>
|
||
<td class="left">Dulaunoy & Iklody</td>
|
||
<td class="center">Expires 4 April 2022</td>
|
||
<td class="right">[Page]</td>
|
||
</tr></tfoot>
|
||
</table>
|
||
<div class="document-information">
|
||
<dl id="identifiers">
|
||
<dt class="label-internet-draft">Internet-Draft:</dt>
|
||
<dd class="internet-draft">draft-01</dd>
|
||
<dt class="label-published">Published:</dt>
|
||
<dd class="published">
|
||
<time datetime="2021-10-01" class="published">1 October 2021</time>
|
||
</dd>
|
||
<dt class="label-intended-status">Intended Status:</dt>
|
||
<dd class="intended-status">Informational</dd>
|
||
<dt class="label-expires">Expires:</dt>
|
||
<dd class="expires"><time datetime="2022-04-04">4 April 2022</time></dd>
|
||
<dt class="label-authors">Authors:</dt>
|
||
<dd class="authors">
|
||
<div class="author">
|
||
<div class="author-name">A. Dulaunoy</div>
|
||
<div class="org">CIRCL</div>
|
||
</div>
|
||
<div class="author">
|
||
<div class="author-name">A. Iklody</div>
|
||
<div class="org">CIRCL</div>
|
||
</div>
|
||
</dd>
|
||
</dl>
|
||
</div>
|
||
<h1 id="title">Programming Methodology Framework aka PMF</h1>
|
||
<section id="section-abstract">
|
||
<h2 id="abstract"><a href="#abstract" class="selfRef">Abstract</a></h2>
|
||
<p id="section-abstract-1">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 <span>[<a href="#PROGRAMMING-MF-MANIFESTO" class="xref">PROGRAMMING-MF-MANIFESTO</a>]</span> 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.<a href="#section-abstract-1" class="pilcrow">¶</a></p>
|
||
</section>
|
||
<div id="status-of-memo">
|
||
<section id="section-boilerplate.1">
|
||
<h2 id="name-status-of-this-memo">
|
||
<a href="#name-status-of-this-memo" class="section-name selfRef">Status of This Memo</a>
|
||
</h2>
|
||
<p id="section-boilerplate.1-1">
|
||
This Internet-Draft is submitted in full conformance with the
|
||
provisions of BCP 78 and BCP 79.<a href="#section-boilerplate.1-1" class="pilcrow">¶</a></p>
|
||
<p id="section-boilerplate.1-2">
|
||
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 <span><a href="https://datatracker.ietf.org/drafts/current/">https://datatracker.ietf.org/drafts/current/</a></span>.<a href="#section-boilerplate.1-2" class="pilcrow">¶</a></p>
|
||
<p id="section-boilerplate.1-3">
|
||
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."<a href="#section-boilerplate.1-3" class="pilcrow">¶</a></p>
|
||
<p id="section-boilerplate.1-4">
|
||
This Internet-Draft will expire on 4 April 2022.<a href="#section-boilerplate.1-4" class="pilcrow">¶</a></p>
|
||
</section>
|
||
</div>
|
||
<div id="copyright">
|
||
<section id="section-boilerplate.2">
|
||
<h2 id="name-copyright-notice">
|
||
<a href="#name-copyright-notice" class="section-name selfRef">Copyright Notice</a>
|
||
</h2>
|
||
<p id="section-boilerplate.2-1">
|
||
Copyright (c) 2021 IETF Trust and the persons identified as the
|
||
document authors. All rights reserved.<a href="#section-boilerplate.2-1" class="pilcrow">¶</a></p>
|
||
<p id="section-boilerplate.2-2">
|
||
This document is subject to BCP 78 and the IETF Trust's Legal
|
||
Provisions Relating to IETF Documents
|
||
(<span><a href="https://trustee.ietf.org/license-info">https://trustee.ietf.org/license-info</a></span>) 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.<a href="#section-boilerplate.2-2" class="pilcrow">¶</a></p>
|
||
</section>
|
||
</div>
|
||
<div id="toc">
|
||
<section id="section-boilerplate.3">
|
||
<a href="#" onclick="scroll(0,0)" class="toplink">▲</a><h2 id="name-table-of-contents">
|
||
<a href="#name-table-of-contents" class="section-name selfRef">Table of Contents</a>
|
||
</h2>
|
||
<nav class="toc"><ul class="toc ulEmpty">
|
||
<li class="toc ulEmpty" id="section-boilerplate.3-1.1">
|
||
<p id="section-boilerplate.3-1.1.1"><a href="#section-1" class="xref">1</a>. <a href="#name-introduction" class="xref">Introduction</a><a href="#section-boilerplate.3-1.1.1" class="pilcrow">¶</a></p>
|
||
<ul class="toc ulEmpty">
|
||
<li class="toc ulEmpty" id="section-boilerplate.3-1.1.2.1">
|
||
<p id="section-boilerplate.3-1.1.2.1.1"><a href="#section-1.1" class="xref">1.1</a>. <a href="#name-management-and-pmf-methodol" class="xref">Management and PMF methodology</a><a href="#section-boilerplate.3-1.1.2.1.1" class="pilcrow">¶</a></p>
|
||
</li>
|
||
<li class="toc ulEmpty" id="section-boilerplate.3-1.1.2.2">
|
||
<p id="section-boilerplate.3-1.1.2.2.1"><a href="#section-1.2" class="xref">1.2</a>. <a href="#name-conventions-and-terminology" class="xref">Conventions and Terminology</a><a href="#section-boilerplate.3-1.1.2.2.1" class="pilcrow">¶</a></p>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
<li class="toc ulEmpty" id="section-boilerplate.3-1.2">
|
||
<p id="section-boilerplate.3-1.2.1"><a href="#section-2" class="xref">2</a>. <a href="#name-security-considerations" class="xref">Security Considerations</a><a href="#section-boilerplate.3-1.2.1" class="pilcrow">¶</a></p>
|
||
</li>
|
||
<li class="toc ulEmpty" id="section-boilerplate.3-1.3">
|
||
<p id="section-boilerplate.3-1.3.1"><a href="#section-3" class="xref">3</a>. <a href="#name-acknowledgements" class="xref">Acknowledgements</a><a href="#section-boilerplate.3-1.3.1" class="pilcrow">¶</a></p>
|
||
</li>
|
||
<li class="toc ulEmpty" id="section-boilerplate.3-1.4">
|
||
<p id="section-boilerplate.3-1.4.1"><a href="#section-4" class="xref">4</a>. <a href="#name-normative-references" class="xref">Normative References</a><a href="#section-boilerplate.3-1.4.1" class="pilcrow">¶</a></p>
|
||
</li>
|
||
<li class="toc ulEmpty" id="section-boilerplate.3-1.5">
|
||
<p id="section-boilerplate.3-1.5.1"><a href="#section-5" class="xref">5</a>. <a href="#name-informative-references" class="xref">Informative References</a><a href="#section-boilerplate.3-1.5.1" class="pilcrow">¶</a></p>
|
||
</li>
|
||
<li class="toc ulEmpty" id="section-boilerplate.3-1.6">
|
||
<p id="section-boilerplate.3-1.6.1"><a href="#section-appendix.a" class="xref"></a> <a href="#name-authors-addresses" class="xref">Authors' Addresses</a><a href="#section-boilerplate.3-1.6.1" class="pilcrow">¶</a></p>
|
||
</li>
|
||
</ul>
|
||
</nav>
|
||
</section>
|
||
</div>
|
||
<div id="introduction">
|
||
<section id="section-1">
|
||
<h2 id="name-introduction">
|
||
<a href="#section-1" class="section-number selfRef">1. </a><a href="#name-introduction" class="section-name selfRef">Introduction</a>
|
||
</h2>
|
||
<p id="section-1-1">In 2011, Zed A. Shaw published a blog post which describes:<a href="#section-1-1" class="pilcrow">¶</a></p>
|
||
<p id="section-1-2">{align="left"} 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.<a href="#section-1-2" class="pilcrow">¶</a></p>
|
||
<p id="section-1-3">The PMF methodology was published as a manifesto later <span>[<a href="#PROGRAMMING-MF-MANIFESTO" class="xref">PROGRAMMING-MF-MANIFESTO</a>]</span>. The manifesto clearly describes the focus on programming to avoid the surrounding management overhead and pivot towards the delivery of the software. The <span>[<a href="#THE-TAO-OF-PROGRAMMING" class="xref">THE-TAO-OF-PROGRAMMING</a>]</span> describes similar methodologies which strongly focus on coding, scripting and programming.<a href="#section-1-3" class="pilcrow">¶</a></p>
|
||
<p id="section-1-4">The overall concept of PMF methodology follows the following process:<a href="#section-1-4" class="pilcrow">¶</a></p>
|
||
<ul>
|
||
<li id="section-1-5.1">Compose a list of features to be implemented and use an iterative programming process.<a href="#section-1-5.1" class="pilcrow">¶</a>
|
||
</li>
|
||
<li id="section-1-5.2">Enhance said features using trial and error programming.<a href="#section-1-5.2" class="pilcrow">¶</a>
|
||
</li>
|
||
<li id="section-1-5.3">Orchestrate your testing and integration processes using pragmatic programming.<a href="#section-1-5.3" class="pilcrow">¶</a>
|
||
</li>
|
||
</ul>
|
||
<p id="section-1-6">Repeat the above process until the software is delivered.<a href="#section-1-6" class="pilcrow">¶</a></p>
|
||
<p id="section-1-7">A simplified overview of the process can be described as follow:<a href="#section-1-7" class="pilcrow">¶</a></p>
|
||
<div id="section-1-8">
|
||
<pre class="sourcecode lang-ascii-art">+----------+
|
||
| |
|
||
| idea <------+
|
||
| | |
|
||
+----+-----+ |
|
||
| |
|
||
| |
|
||
+----v-----+ |
|
||
| | | it doesn't work
|
||
| code | |
|
||
| | |
|
||
+----+-----+ |
|
||
| |
|
||
| |
|
||
+----v-----+ |
|
||
| | |
|
||
| release +------+
|
||
| |
|
||
+----------+
|
||
</pre><a href="#section-1-8" class="pilcrow">¶</a>
|
||
</div>
|
||
<p id="section-1-9">The PMF methodology covers open source software along with proprietary software and can be used interchangeably in both.<a href="#section-1-9" class="pilcrow">¶</a></p>
|
||
<div id="management-and-pmf-methodology">
|
||
<section id="section-1.1">
|
||
<h3 id="name-management-and-pmf-methodol">
|
||
<a href="#section-1.1" class="section-number selfRef">1.1. </a><a href="#name-management-and-pmf-methodol" class="section-name selfRef">Management and PMF methodology</a>
|
||
</h3>
|
||
<p id="section-1.1-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.<a href="#section-1.1-1" class="pilcrow">¶</a></p>
|
||
<ul>
|
||
<li id="section-1.1-2.1">Collect requirements of the users/customers.<a href="#section-1.1-2.1" class="pilcrow">¶</a>
|
||
</li>
|
||
<li id="section-1.1-2.2">Provide programmers with the desired requirements.<a href="#section-1.1-2.2" class="pilcrow">¶</a>
|
||
</li>
|
||
<li id="section-1.1-2.3">Review whether the software to be delivered matches the requirements.<a href="#section-1.1-2.3" class="pilcrow">¶</a>
|
||
</li>
|
||
</ul>
|
||
</section>
|
||
</div>
|
||
<div id="conventions-and-terminology">
|
||
<section id="section-1.2">
|
||
<h3 id="name-conventions-and-terminology">
|
||
<a href="#section-1.2" class="section-number selfRef">1.2. </a><a href="#name-conventions-and-terminology" class="section-name selfRef">Conventions and Terminology</a>
|
||
</h3>
|
||
<p id="section-1.2-1">The key words "<span class="bcp14">MUST</span>", "<span class="bcp14">MUST NOT</span>", "<span class="bcp14">REQUIRED</span>", "<span class="bcp14">SHALL</span>", "<span class="bcp14">SHALL NOT</span>",
|
||
"<span class="bcp14">SHOULD</span>", "<span class="bcp14">SHOULD NOT</span>", "<span class="bcp14">RECOMMENDED</span>", "<span class="bcp14">MAY</span>", and "<span class="bcp14">OPTIONAL</span>" in this
|
||
document are to be interpreted as described in RFC 2119 <span>[<a href="#RFC2119" class="xref">RFC2119</a>]</span>.<a href="#section-1.2-1" class="pilcrow">¶</a></p>
|
||
</section>
|
||
</div>
|
||
</section>
|
||
</div>
|
||
<div id="security-considerations">
|
||
<section id="section-2">
|
||
<h2 id="name-security-considerations">
|
||
<a href="#section-2" class="section-number selfRef">2. </a><a href="#name-security-considerations" class="section-name selfRef">Security Considerations</a>
|
||
</h2>
|
||
<p id="section-2-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.<a href="#section-2-1" class="pilcrow">¶</a></p>
|
||
</section>
|
||
</div>
|
||
<div id="acknowledgements">
|
||
<section id="section-3">
|
||
<h2 id="name-acknowledgements">
|
||
<a href="#section-3" class="section-number selfRef">3. </a><a href="#name-acknowledgements" class="section-name selfRef">Acknowledgements</a>
|
||
</h2>
|
||
<p id="section-3-1">The authors wish to thank all the programmers who program.<a href="#section-3-1" class="pilcrow">¶</a></p>
|
||
</section>
|
||
</div>
|
||
<section id="section-4">
|
||
<h2 id="name-normative-references">
|
||
<a href="#section-4" class="section-number selfRef">4. </a><a href="#name-normative-references" class="section-name selfRef">Normative References</a>
|
||
</h2>
|
||
<dl class="references">
|
||
<dt id="RFC2119">[RFC2119]</dt>
|
||
<dd>
|
||
<span class="refAuthor">Bradner, S.</span>, <span class="refTitle">"Key words for use in RFCs to Indicate Requirement Levels"</span>, <span class="seriesInfo">BCP 14</span>, <span class="seriesInfo">RFC 2119</span>, <span class="seriesInfo">DOI 10.17487/RFC2119</span>, <time datetime="1997-03">March 1997</time>
|
||
<span>, <<a href="https://www.rfc-editor.org/info/rfc2119">https://www.rfc-editor.org/info/rfc2119</a>></span>. </dd>
|
||
</dl>
|
||
</section>
|
||
<section id="section-5">
|
||
<h2 id="name-informative-references">
|
||
<a href="#section-5" class="section-number selfRef">5. </a><a href="#name-informative-references" class="section-name selfRef">Informative References</a>
|
||
</h2>
|
||
<dl class="references">
|
||
<dt id="PROGRAMMING-MF-MANIFESTO">[PROGRAMMING-MF-MANIFESTO]</dt>
|
||
<dd>
|
||
<span class="refAuthor">Shaw, Z. A.</span>, <span class="refTitle">"Programming Motherfucker, do you speak it?"</span>, <span class="refContent"></span>, <time datetime="2021-10">October 2021</time>
|
||
<span>, <<a href="http://programming-motherfucker.com">http://programming-motherfucker.com</a>></span>. </dd>
|
||
<dt id="THE-TAO-OF-PROGRAMMING">[THE-TAO-OF-PROGRAMMING]</dt>
|
||
<dd>
|
||
<span class="refAuthor">James, G.</span>, <span class="refTitle">"The Tao of Programming"</span>, <span class="refContent"></span>, <time datetime="2021-10">October 2021</time>
|
||
<span>, <<a href="http://www.mit.edu/~xela/tao.html">http://www.mit.edu/~xela/tao.html</a>></span>. </dd>
|
||
</dl>
|
||
</section>
|
||
<div id="authors-addresses">
|
||
<section id="section-appendix.a">
|
||
<h2 id="name-authors-addresses">
|
||
<a href="#name-authors-addresses" class="section-name selfRef">Authors' Addresses</a>
|
||
</h2>
|
||
<address class="vcard">
|
||
<div dir="auto" class="left"><span class="org">Computer Incident Response Center Luxembourg</span></div>
|
||
<div dir="auto" class="left"><span class="fn nameRole">Alexandre Dulaunoy</span></div>
|
||
<div dir="auto" class="left"><span class="street-address">16, bd d'Avranches</span></div>
|
||
<div dir="auto" class="left">L-<span class="postal-code">L-1160</span> <span class="locality">Luxembourg</span>
|
||
</div>
|
||
<div dir="auto" class="left"><span class="country-name">Luxembourg</span></div>
|
||
<div class="tel">
|
||
<span>Phone:</span>
|
||
<a href="tel:+352%20247%2088444" class="tel">+352 247 88444</a>
|
||
</div>
|
||
<div class="email">
|
||
<span>Email:</span>
|
||
<a href="mailto:alexandre.dulaunoy@circl.lu" class="email">alexandre.dulaunoy@circl.lu</a>
|
||
</div>
|
||
</address>
|
||
<address class="vcard">
|
||
<div dir="auto" class="left"><span class="org">Computer Incident Response Center Luxembourg</span></div>
|
||
<div dir="auto" class="left"><span class="fn nameRole">Andras Iklody</span></div>
|
||
<div dir="auto" class="left"><span class="street-address">16, bd d'Avranches</span></div>
|
||
<div dir="auto" class="left">L-<span class="postal-code">L-1160</span> <span class="locality">Luxembourg</span>
|
||
</div>
|
||
<div dir="auto" class="left"><span class="country-name">Luxembourg</span></div>
|
||
<div class="tel">
|
||
<span>Phone:</span>
|
||
<a href="tel:+352%20247%2088444" class="tel">+352 247 88444</a>
|
||
</div>
|
||
<div class="email">
|
||
<span>Email:</span>
|
||
<a href="mailto:andras.iklody@circl.lu" class="email">andras.iklody@circl.lu</a>
|
||
</div>
|
||
</address>
|
||
</section>
|
||
</div>
|
||
<script>var toc = document.getElementById("toc");
|
||
var tocToggle = toc.querySelector("h2");
|
||
var tocNav = toc.querySelector("nav");
|
||
|
||
// mobile menu toggle
|
||
tocToggle.onclick = function(event) {
|
||
if (window.innerWidth < 1024) {
|
||
var tocNavDisplay = tocNav.currentStyle ? tocNav.currentStyle.display : getComputedStyle(tocNav, null).display;
|
||
if (tocNavDisplay == "none") {
|
||
tocNav.style.display = "block";
|
||
} else {
|
||
tocNav.style.display = "none";
|
||
}
|
||
}
|
||
}
|
||
|
||
// toc anchor scroll to anchor
|
||
tocNav.addEventListener("click", function (event) {
|
||
event.preventDefault();
|
||
if (event.target.nodeName == 'A') {
|
||
if (window.innerWidth < 1024) {
|
||
tocNav.style.display = "none";
|
||
}
|
||
var href = event.target.getAttribute("href");
|
||
var anchorId = href.substr(1);
|
||
var anchor = document.getElementById(anchorId);
|
||
anchor.scrollIntoView(true);
|
||
window.history.pushState("","",href);
|
||
}
|
||
});
|
||
|
||
// switch toc mode when window resized
|
||
window.onresize = function () {
|
||
if (window.innerWidth < 1024) {
|
||
tocNav.style.display = "none";
|
||
} else {
|
||
tocNav.style.display = "block";
|
||
}
|
||
}
|
||
</script>
|
||
</body>
|
||
</html>
|