<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
	<channel>
		<title>Handbook on cotty</title>
		<link>https://nowa.im/cotty/handbook/</link>
		<description>Recent content in Handbook on cotty</description>
		<generator>Hugo</generator>
		<language>en</language>
		
		
		
		
			<atom:link href="https://nowa.im/cotty/handbook/index.xml" rel="self" type="application/rss+xml" />
			<item>
				<title>Documentation system</title>
				<link>https://nowa.im/cotty/handbook/documentation/</link>
				<pubDate>Sun, 22 Nov 2026 00:00:00 +0000</pubDate>
				<guid>https://nowa.im/cotty/handbook/documentation/</guid>
				<description>&lt;p&gt;This page defines how cotty&amp;rsquo;s documents are organized, what each kind contains, and the rules that keep them current. It is the normative description. &lt;a href=&#34;https://nowa.im/cotty/rfcs/0001-documentation-system/&#34;&gt;RFC 0001&lt;/a&gt; records why it is this way.&lt;/p&gt;&#xA;&lt;h2 id=&#34;two-kinds-of-document&#34;&gt;Two kinds of document&lt;a class=&#34;anchor&#34; href=&#34;#two-kinds-of-document&#34; aria-hidden=&#34;true&#34; tabindex=&#34;-1&#34;&gt;&lt;/a&gt;&lt;/h2&gt;&#xA;&lt;p&gt;Documents rot when one page mixes two meanings of time. Every document here is one of two kinds:&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;A &lt;strong&gt;state document&lt;/strong&gt; describes what is true now. There is exactly one copy. It is always current and may be rewritten at any time.&lt;/li&gt;&#xA;&lt;li&gt;An &lt;strong&gt;event document&lt;/strong&gt; records what was proposed, decided or found at a point in time. It carries a date. Once accepted or finished it is not rewritten; later events are added beside it.&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;Documents also belong to one of two spaces: the problem space (why, and what) or the solution space (how).&lt;/p&gt;</description>
			</item>
			<item>
				<title>RFC process</title>
				<link>https://nowa.im/cotty/handbook/rfc-process/</link>
				<pubDate>Sun, 22 Nov 2026 00:00:00 +0000</pubDate>
				<guid>https://nowa.im/cotty/handbook/rfc-process/</guid>
				<description>&lt;p&gt;An RFC records one technical decision: what is proposed, why, and what was rejected. This page defines when an RFC is needed and how it moves from draft to accepted.&lt;/p&gt;&#xA;&lt;h2 id=&#34;what-an-rfc-contains&#34;&gt;What an RFC contains&lt;a class=&#34;anchor&#34; href=&#34;#what-an-rfc-contains&#34; aria-hidden=&#34;true&#34; tabindex=&#34;-1&#34;&gt;&lt;/a&gt;&lt;/h2&gt;&#xA;&lt;p&gt;RFCs are thin. An RFC holds the decision and its reasoning. It does not hold the normative text. The exact rules, formats and behavior are written in the state documents the RFC changes: architecture pages, specifications, handbook pages. Those changes belong to the same change set as the RFC.&lt;/p&gt;</description>
			</item>
			<item>
				<title>Templates</title>
				<link>https://nowa.im/cotty/handbook/templates/</link>
				<pubDate>Sun, 22 Nov 2026 00:00:00 +0000</pubDate>
				<guid>https://nowa.im/cotty/handbook/templates/</guid>
				<description>&lt;p&gt;This page holds the skeleton of each kind of document. To start a document, copy the skeleton into a new file in both languages. The sentence under each heading says what belongs there; replace it. A section that does not apply stays, with one line saying why.&lt;/p&gt;&#xA;&lt;p&gt;The metadata fields are defined in &lt;a href=&#34;https://nowa.im/cotty/handbook/documentation/#metadata&#34;&gt;Documentation system&lt;/a&gt;.&lt;/p&gt;&#xA;&lt;h2 id=&#34;capability-page&#34;&gt;Capability page&lt;a class=&#34;anchor&#34; href=&#34;#capability-page&#34; aria-hidden=&#34;true&#34; tabindex=&#34;-1&#34;&gt;&lt;/a&gt;&lt;/h2&gt;&#xA;&lt;p&gt;A capability page lives in &lt;code&gt;product/&lt;/code&gt;. It describes one thing the product does, from the user&amp;rsquo;s side.&lt;/p&gt;</description>
			</item>
			<item>
				<title>Site design</title>
				<link>https://nowa.im/cotty/handbook/site-design/</link>
				<pubDate>Sun, 22 Nov 2026 00:00:00 +0000</pubDate>
				<guid>https://nowa.im/cotty/handbook/site-design/</guid>
				<description>&lt;p&gt;This page defines how the site looks: its grid, its type, its colors, and the details it takes from the history of the terminal. The stylesheet &lt;code&gt;site/assets/css/site.css&lt;/code&gt; implements it. Where the two disagree, this page governs.&lt;/p&gt;&#xA;&lt;h2 id=&#34;the-idea&#34;&gt;The idea&lt;a class=&#34;anchor&#34; href=&#34;#the-idea&#34; aria-hidden=&#34;true&#34; tabindex=&#34;-1&#34;&gt;&lt;/a&gt;&lt;/h2&gt;&#xA;&lt;p&gt;The whole is plain and the detail is local. Three decisions carry the design.&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;One grid.&lt;/strong&gt; The page is a screen, measured in characters. Its widths are the widths of the terminals that came before it.&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;Two voices.&lt;/strong&gt; Prose is set in a sans-serif face. Labels, metadata, navigation and code are set in a monospace face. A person speaks, and the machine labels.&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;Two colors.&lt;/strong&gt; Blue marks where you can go. Rose marks where you are, and what needs you.&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;A line is drawn only where it says something: the status line, the rules of a table, the mark at the end of a page. There is no rule under the header and none above the footer.&lt;/p&gt;</description>
			</item>
	</channel>
</rss>
