<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Contributing on AgStack Documentation</title><link>https://docs.agstack.org/contributing/</link><description>Recent content in Contributing on AgStack Documentation</description><generator>Hugo</generator><language>en-us</language><atom:link href="https://docs.agstack.org/contributing/index.xml" rel="self" type="application/rss+xml"/><item><title>Multi-repo documentation</title><link>https://docs.agstack.org/contributing/multi-repo/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.agstack.org/contributing/multi-repo/</guid><description>&lt;h2 id="the-mechanism"&gt;The mechanism&lt;/h2&gt;&#10;&lt;p&gt;Each documented component repository is a &lt;strong&gt;git submodule&lt;/strong&gt; under &lt;code&gt;external/&lt;/code&gt;,&#10;pinned to an exact commit. Hugo mounts that submodule&amp;rsquo;s &lt;code&gt;docs/&lt;/code&gt; directory into&#10;&lt;code&gt;assets/&lt;/code&gt;, and a &lt;strong&gt;content adapter&lt;/strong&gt; turns the files into pages.&lt;/p&gt;&#10;&lt;pre tabindex="0"&gt;&lt;code&gt;docs/&#10;├── config/_default/hugo.toml module mounts live here&#10;├── external/&#10;│ └── pancake/ submodule, pinned by commit&#10;│ └── docs/*.md upstream files, never edited here&#10;├content/pancake/&#10;│ ├── _index.md section index, authored here&#10;│ └── _content.gotmpl adapter: files -&amp;gt; pages&#10;└── layouts/&#10; ├── _markup/render-link.html rewrites `*.md` cross-links&#10; └── _td-content-after-header.html provenance banner&#10;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Reading order, once you want to change something:&lt;/p&gt;</description></item><item><title>Licensing</title><link>https://docs.agstack.org/contributing/licensing/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.agstack.org/contributing/licensing/</guid><description>&lt;div class="pageinfo pageinfo-primary"&gt;&#10;&lt;p&gt;Pages &lt;strong&gt;authored in this repository&lt;/strong&gt; are &lt;a href="https://creativecommons.org/licenses/by-sa/4.0/"&gt;CC BY-SA 4.0&lt;/a&gt;&#10;.&#10;Pages &lt;strong&gt;imported from a component repository&lt;/strong&gt; are covered by &lt;em&gt;that repository&amp;rsquo;s&lt;/em&gt;&#10;licence, not this one. Every imported page names its licence in the banner at the&#10;top.&lt;/p&gt;&#10;&lt;/div&gt;&#10;&lt;h2 id="why-there-are-two-answers"&gt;Why there are two answers&lt;/h2&gt;&#10;&lt;p&gt;This site is not the origin of everything it publishes. Some pages are written&#10;here; others are the component repositories&amp;rsquo; own &lt;code&gt;docs/&lt;/code&gt; directories, pulled in as&#10;git submodules and rendered unchanged. Re-licensing someone else&amp;rsquo;s documentation&#10;by the act of displaying it would be both wrong and impossible — the licence&#10;travels with the work, not with the renderer.&lt;/p&gt;</description></item></channel></rss>