Deployed 79d71f2 to main with MkDocs 1.5.3 and mike 2.1.3

Author: kcp-ci-bot

main/contributing/guides/publishing-a-new-kcp-release/index.html

@@ -3853,20 +3853,22 @@ <h3 id="create-the-tag">Create the Tag<a class="headerlink" href="#create-the-ta
 </div>
 <ol>
 <li><code>git fetch</code> from the main kcp repository (kcp-dev/kcp) to ensure you have the latest commits</li>
-<li>Tag the main module</li>
-<li>If your git remote for kcp-dev/kcp is named something other than <code>upstream</code>, change <code>REF</code> accordingly</li>
 <li>
-<p>If you are creating a release from a release branch, change <code>main</code> in <code>REF</code> accordingly, or you can
-      make <code>REF</code> a commit hash.</p>
+<p>Tag the main module</p>
+<ol>
+<li>If your git remote for kcp-dev/kcp is named something other than <code>upstream</code>, change <code>REF</code> accordingly</li>
+<li>If you are creating a release from a release branch, change <code>main</code> in <code>REF</code> accordingly, or you can
+   make <code>REF</code> a commit hash.</li>
+</ol>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nv">REF</span><span class="o">=</span>upstream/main
-<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nv">TAG</span><span class="o">=</span>v1.2.3
+<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="nv">TAG</span><span class="o">=</span>&lt;tag&gt;<span class="w"> </span><span class="c1"># e.g. v1.2.3</span>
 <a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>git<span class="w"> </span>tag<span class="w"> </span>--sign<span class="w"> </span>--message<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$TAG</span><span class="s2">&quot;</span><span class="w"> </span><span class="s2">&quot;</span><span class="nv">$TAG</span><span class="s2">&quot;</span><span class="w"> </span><span class="s2">&quot;</span><span class="nv">$REF</span><span class="s2">&quot;</span>
 </code></pre></div>
 </li>
 </ol>
 <h3 id="push-the-tag">Push the Tag<a class="headerlink" href="#push-the-tag" title="Permanent link">&para;</a></h3>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="nv">REMOTE</span><span class="o">=</span>upstream
-<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nv">TAG</span><span class="o">=</span>v1.2.3
+<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="nv">TAG</span><span class="o">=</span>&lt;tag&gt;<span class="w"> </span><span class="c1"># e.g. v1.2.3</span>
 <a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a>git<span class="w"> </span>push<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$REMOTE</span><span class="s2">&quot;</span><span class="w"> </span><span class="s2">&quot;</span><span class="nv">$TAG</span><span class="s2">&quot;</span>
 </code></pre></div>
 <h2 id="if-its-a-new-minor-version">If it's a New Minor Version<a class="headerlink" href="#if-its-a-new-minor-version" title="Permanent link">&para;</a></h2>
@@ -3877,7 +3879,7 @@ <h3 id="create-a-release-branch">Create a Release Branch<a class="headerlink" hr
 <p>Set <code>REMOTE</code>, <code>REF</code>, and <code>VERSION</code> as appropriate.</p>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nv">REMOTE</span><span class="o">=</span>upstream
 <a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="nv">REF</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$REMOTE</span><span class="s2">/main&quot;</span>
-<a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nv">VERSION</span><span class="o">=</span><span class="m">1</span>.2
+<a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="nv">VERSION</span><span class="o">=</span>&lt;version&gt;<span class="w"> </span><span class="c1"># e.g. 1.2</span>
 <a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a>git<span class="w"> </span>checkout<span class="w"> </span>-b<span class="w"> </span><span class="s2">&quot;release-</span><span class="nv">$VERSION</span><span class="s2">&quot;</span><span class="w"> </span><span class="s2">&quot;</span><span class="nv">$REF</span><span class="s2">&quot;</span>
 <a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>git<span class="w"> </span>push<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$REMOTE</span><span class="s2">&quot;</span><span class="w"> </span><span class="s2">&quot;release-</span><span class="nv">$VERSION</span><span class="s2">&quot;</span>
 </code></pre></div>
@@ -3926,7 +3928,7 @@ <h2 id="trigger-documentation-deployment">Trigger Documentation Deployment<a cla
 <p>Documentation for the respective release branch needs to be triggered manually after the release branch has been pushed.</p>
 <ol>
 <li>Navigate to the <a href="https://github.com/kcp-dev/kcp/actions/workflows/docs-gen-and-push.yaml">Generate and push docs</a> GitHub Action.</li>
-<li>Hit the "Run forkflow" button, run workflow against <code>release-$VERSION</code>.</li>
+<li>Hit the "Run workflow" button, run workflow against <code>release-$VERSION</code>.</li>
 <li>Make sure the triggered workflow ran and deployed a new version of the documentation to <a href="https://docs.kcp.io">docs.kcp.io</a>.</li>
 </ol>
 <h2 id="notify">Notify<a class="headerlink" href="#notify" title="Permanent link">&para;</a></h2>

main/contributing/monorepo/index.html

@@ -3726,8 +3726,10 @@ <h1 id="monorepo-structure">Monorepo Structure<a class="headerlink" href="#monor
 <p>At the moment, the following libraries are part of the monorepo:</p>
 <ul>
 <li><a href="https://github.com/kcp-dev/apimachinery">kcp-dev/apimachinery</a></li>
+<li><a href="https://github.com/kcp-dev/cli">kcp-dev/cli</a></li>
 <li><a href="https://github.com/kcp-dev/client-go">kcp-dev/client-go</a></li>
 <li><a href="https://github.com/kcp-dev/code-generator">kcp-dev/code-generator</a></li>
+<li><a href="https://github.com/kcp-dev/sdk">kcp-dev/sdk</a></li>
 </ul>
 <h2 id="terminology">Terminology<a class="headerlink" href="#terminology" title="Permanent link">&para;</a></h2>
 <ul>
@@ -3745,7 +3747,8 @@ <h2 id="high-level-overview">High Level Overview<a class="headerlink" href="#hig
 <p>The source code for staging repositories is located on the special path in the monorepo which is
 <a href="https://github.com/kcp-dev/kcp/tree/main/staging/src/github.com/kcp-dev"><code>./staging/src/github.com/kcp-dev</code></a>.
 Every subdirectory on that path corresponds to a single staging repository.
-The code in the staging/ directory is authoritative, i.e. the only copy of the code. You can directly modify such code.</p>
+The code in the <code>staging/</code> directory is authoritative, i.e. the only copy of the code. You can directly modify such
+code.</p>
 <p>In order to preserve standalone Go modules for each staging repository, the source code from staging repositories
 is mirrored to standalone (aka published) repositories. The mirroring is an automatic process happening every
 several hours.</p>
@@ -3760,7 +3763,7 @@ <h2 id="handling-tags">Handling Tags<a class="headerlink" href="#handling-tags"
 version v2 will be v2.29.0.</p>
 <p>Concretely:</p>
 <ul>
-<li>kcp-dev/client-go has the Go module major version at v0, so tags will be v0.x.y</li>
+<li>kcp-dev/cli, kcp-dev/client-go, and kcp-dev/sdk have the Go module major version at v0, so tags will be v0.x.y</li>
 <li>kcp-dev/apimachinery has the Go module major version at v2, so tags will be v2.x.y</li>
 <li>kcp-dev/code-generator has the Go module major version at v3, so tags will be v3.x.y</li>
 </ul>
@@ -3774,6 +3777,7 @@ <h2 id="implementation">Implementation<a class="headerlink" href="#implementatio
 <ul>
 <li>Add support for running publishing-bot on ARM64</li>
 <li>Add image building process compatible with kcp</li>
+<li>Add support for non-v0 and non-v1 Go modules</li>
 <li>Add support for customizing tags mirroring</li>
 <li>Add kcp-related configuration</li>
 </ul>
@@ -3784,6 +3788,10 @@ <h2 id="implementation">Implementation<a class="headerlink" href="#implementatio
 issue being open indicates that the bot is not healthy and at least the last run has failed.</p>
 <p>The kcp configuration for publishing-bot can be found at https://github.com/kcp-dev/publishing-bot/blob/master/configs/kcp-dev</p>
 <p>The mirroring rules are located in the kcp-dev/kcp repoitory and can be found at https://github.com/kcp-dev/kcp/blob/main/staging/publishing/rules.yaml</p>
+<p>The kcp project also has a testing envrionment for publishing-bot called <code>kcp-nightly</code>. There's a dedicated <a href="https://github.com/kcp-nightly">GitHub
+organization</a> and a dedicated instance of publishing-bot running in the
+<code>publishing-bot-nightly</code> namespace in the Prow control plane cluster. The publishing-bot configuration for the
+<code>kcp-nightly</code> environemnt can be found at https://github.com/kcp-dev/publishing-bot/blob/master/configs/kcp-nightly</p>
 <p>At the moment, the bot is configured to run every 4 hours.</p>
 <h2 id="creating-a-new-staging-repository">Creating a New Staging Repository<a class="headerlink" href="#creating-a-new-staging-repository" title="Permanent link">&para;</a></h2>
 <p>Adding a completely new staging repository to the monorepo must follow this process:</p>
@@ -3794,12 +3802,13 @@ <h2 id="creating-a-new-staging-repository">Creating a New Staging Repository<a c
   <a href="https://github.com/kcp-dev/kcp">kcp-dev/kcp</a> repository</li>
 <li>Create a staging repository in <code>staging/src/github.com/kcp-dev</code> with all required files for a repository
   (e.g. LICENSE, OWNERS...)</li>
-<li>Create a new Git repository on GitHub to serve as a published repository with an empty initial commit</li>
+<li>Create a new Git repository on GitHub to serve as a published repository with an <strong>empty</strong> initial commit</li>
 <li>Update the publishing-bot rules to mirror from the new staging repository to the new published repository</li>
 </ul>
 <p>Adding an existing standalone repository to the monorepo is generally discouraged and will be considered on
-a case-by-case basis by Maintainers. This case requires following different steps that will be documented
-in the future.</p>
+a case-by-case basis by Maintainers. This case requires following different steps that are documented as part of the
+monorepo proposal: https://github.com/kcp-dev/enhancements/pull/7</p>
+<!-- TODO(xmudrii): replace the PR link with a link to the document once merged -->