<?xml version="1.0" encoding="utf-8"?>
<!-- name="GENERATOR" content="github.com/mmarkdown/mmark Mmark Markdown Processor - mmark.miek.nl" -->
<rfc version="3" ipr="trust200902" docName="draft-dulaunoy-programming-methodology-framework-03" submissionType="independent" category="info" xml:lang="en" xmlns:xi="http://www.w3.org/2001/XInclude" indexInclude="true">

<front>
<title abbrev="PMF - Programming Methodology Framework">Programming Methodology Framework aka PMF</title><seriesInfo value="draft-dulaunoy-programming-methodology-framework-03" stream="independent" status="informational" name="Internet-Draft"></seriesInfo>

<author initials="A." surname="Dulaunoy" fullname="Alexandre Dulaunoy"><organization abbrev="CIRCL">Computer Incident Response Center Luxembourg</organization><address><postal><street>122, rue Adolphe Fischer</street>
<city>Luxembourg</city>
<code>L-1521</code>
<country>Luxembourg</country>
</postal><phone>+352 247 88444</phone>
<email>alexandre.dulaunoy@circl.lu</email>
</address></author><author initials="A." surname="Iklody" fullname="Andras Iklody"><organization abbrev="CIRCL">Computer Incident Response Center Luxembourg</organization><address><postal><street>122, rue Adolphe Fischer</street>
<city>Luxembourg</city>
<code>L-1521</code>
<country>Luxembourg</country>
</postal><phone>+352 247 88444</phone>
<email>andras.iklody@circl.lu</email>
</address></author>
<area>Internet</area>
<workgroup></workgroup>
<keyword>software engineering</keyword>
<keyword>engineering</keyword>
<keyword>pmf</keyword>
<keyword>programming</keyword>

<abstract>
<t>This document describes the Programming Methodology Framework, also known as the PMF methodology. The methodology is based on the manifesto written by Zed A. Shaw <xref target="PROGRAMMING-MF-MANIFESTO"></xref>, which
describes a natural approach to software engineering with a strong focus on the act of programming. The PMF methodology uses a neutral name to provide a non-partisan reference
for official engineering or project documents describing one of the most widely used software engineering methodologies.</t>
</abstract>

</front>

<middle>

<section anchor="introduction"><name>Introduction</name>
<t>In 2011, Zed A. Shaw published a blog post which describes:</t>
<t>{align=&quot;left&quot;} 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 PMF methodology was later published as a manifesto <xref target="PROGRAMMING-MF-MANIFESTO"></xref>. The manifesto clearly describes the focus on programming as a way to avoid surrounding management overhead and pivot towards software delivery. <xref target="THE-TAO-OF-PROGRAMMING"></xref> describes similar methodologies that strongly focus on coding, scripting, and programming.</t>
<t>The overall concept of PMF methodology follows the following process:</t>

<ul spacing="compact">
<li>Compose a list of features to be implemented and use an iterative programming process.</li>
<li>Enhance said features using trial and error programming.</li>
<li>Orchestrate your testing and integration processes using pragmatic programming.</li>
</ul>
<t>Repeat the above process until the software is delivered.</t>
<t>A simplified overview of the process can be described as follows:</t>

<sourcecode type="ascii-art"><![CDATA[+----------+
|          |
|   idea   <------+
|          |      |
+----+-----+      |
     |            |
     |            |
+----v-----+      |
|          |      | it doesn't work
|   code   |      |
|          |      |
+----+-----+      |
     |            |
     |            |
+----v-----+      |
|          |      |
|  release +------+
|          |
+----------+
]]>
</sourcecode>
<t>The PMF methodology covers both open source and proprietary software and can be used interchangeably in either context.</t>

<section anchor="management-and-pmf-methodology"><name>Management and PMF methodology</name>
<t>A simple management process is a requirement of the PMF methodology.
The management process is meant to complement, rather than interfere with,
the programming aspect, and it serves solely to support the PMF methodology.</t>

<ul spacing="compact">
<li>Collect requirements of the users/customers.</li>
<li>Provide programmers with the desired requirements.</li>
<li>Review whether the software to be delivered matches the requirements.</li>
</ul>
</section>

<section anchor="swearwords-and-software-engineering"><name>Swearwords and Software Engineering</name>
<t>PMF recognises that the vocabulary found in source code, comments, commit
messages, and adjacent engineering conversations can carry useful information
about how programmers experience the code they maintain. Strehmel's empirical
study of open-source C repositories compared projects containing English
swearwords with projects that did not contain them and reported that the former
set showed significantly better adherence to coding standards under several
statistical tests <xref target="SWEARWORDS-CODE-QUALITY"></xref>.</t>
<t>This observation is important for PMF because it treats apparently informal
programmer expression as a signal that can be studied rather than dismissed.
Swearwords can indicate emotional involvement, frustration with unnecessary
complexity, or unusually direct feedback about code paths that deserve
attention. In practical software engineering, such signals can help teams
identify confusing interfaces, fragile components, and places where programmers
have invested enough attention to leave candid warnings for future readers.</t>
<t>The correlation MUST NOT be interpreted as a recommendation to add swearwords
to source code to improve quality. PMF instead recommends that teams preserve
useful technical context, review emotionally charged comments with empathy, and
turn the underlying engineering signal into tests, refactoring, documentation,
or clearer interfaces.</t>
</section>

<section anchor="conventions-and-terminology"><name>Conventions and Terminology</name>
<t>The key words &quot;<bcp14>MUST</bcp14>&quot;, &quot;<bcp14>MUST NOT</bcp14>&quot;, &quot;<bcp14>REQUIRED</bcp14>&quot;, &quot;<bcp14>SHALL</bcp14>&quot;, &quot;<bcp14>SHALL NOT</bcp14>&quot;,
&quot;<bcp14>SHOULD</bcp14>&quot;, &quot;<bcp14>SHOULD NOT</bcp14>&quot;, &quot;<bcp14>RECOMMENDED</bcp14>&quot;, &quot;<bcp14>MAY</bcp14>&quot;, and &quot;<bcp14>OPTIONAL</bcp14>&quot; in this
document are to be interpreted as described in RFC 2119 <xref target="RFC2119"></xref>.</t>
</section>
</section>

<section anchor="security-considerations"><name>Security Considerations</name>
<t>Secure and defensive programming can only come from practicing programming, and this also
includes the act of simplifying or removing code to reduce the attack surface.</t>
</section>

<section anchor="acknowledgements"><name>Acknowledgements</name>
<t>The authors wish to thank all the programmers who program.</t>
</section>

</middle>

<back>
<references><name>References</name>
<references><name>Normative References</name>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/>
</references>
<references><name>Informative References</name>
<reference anchor="PROGRAMMING-MF-MANIFESTO" target="http://programming-motherfucker.com">
  <front>
    <title>Programming Motherfucker, do you speak it?</title>
    <author fullname="Zed A. Shaw" surname="Shaw"></author>
    <date></date>
  </front>
</reference>
<reference anchor="SWEARWORDS-CODE-QUALITY" target="https://cme.h-its.org/exelixis/pubs/JanThesis.pdf">
  <front>
    <title>Is there a Correlation between the Use of Swearwords and Code Quality in Open Source Code?</title>
    <author fullname="Jan Strehmel" initials="J." surname="Strehmel"></author>
    <date year="2023"></date>
  </front>
</reference>
<reference anchor="THE-TAO-OF-PROGRAMMING" target="http://www.mit.edu/~xela/tao.html">
  <front>
    <title>The Tao of Programming</title>
    <author fullname="Geoffrey James" surname="James"></author>
    <date></date>
  </front>
</reference>
</references>
</references>

</back>

</rfc>
