blob: e0f0c1dcad0f3ed8b95e4ec464e4522b52c5b04b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
<head><script src="/livereload.js?mindelay=10&v=2&port=1313&path=livereload" data-no-instant defer></script>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="icon" type="image/png" sizes="32x32" href="/images/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/images/favicon-16x16.png">
<link rel="manifest" href="/images/site.webmanifest">
<link rel="stylesheet" href="/css/style.css" />
<link rel="stylesheet" href="/css/fonts.css" />
<script async type="text/javascript" src="js/code.js"> </script>
</head>
<div class="container">
<ul id="bar">
<li>
<a href="/">go back</a>
</li>
<li>|</li>
<li>
<a href="mailto:mati.rewa@gmail.com">mati.rewa@gmail.com</a>
</li>
<li>|</li>
<li>
<a href="https://git.denounce.ai/">git.denounce.ai</a>
</li>
<li>|</li>
<li>
<a href="https://ohmyghost.nl">ohmyghost.nl</a>
</li>
<li>|</li>
<li>
<a href="https://atlarge-research.com/mkwiatkowski/">research</a>
</li>
<li>|</li>
<li>
book blog
</li>
</ul>
</div>
</div>
<div class="container">
<h2>The Mythical Man Month</h2>
<p><em>The Other Face</em> is a chapter which tries to explain what good documentation looks like.
Brooks describes nine principles which should guide the programmer to write a useful description.
I won’t cite them here, but what is more interesting is that he suggests that it is imperative the coder writes the documentation <em>before</em> starting to code.</p>
</div>
<footer style="vertical-align: bottom;">
<div style="display: inline-block; margin-left:15px;">
<center>
© Copyright 2024-2025 Mateusz J. Kwiatkowski. All Rights Reserved.
</center>
</div>
</footer>
</body>
</html>
|