Deploy preview for PR 82 🛫

pr-preview/pr-82/_sources/file-formats.rst.txt

@@ -150,9 +150,9 @@ runtime layer in (for
 example, to update to new OpenSSL versions or CPython maintenance releases),
 without needing to republish the upper layers that use that base runtime.
 
-.. _warning: The current handling of the ``runtime_name`` field in the layer
-   metadata is highly questionable, and hence subject to change in future
-   releases without a deprecation period.
+.. warning:: The current handling of the ``runtime_name`` field in the layer
+             metadata is highly questionable, and hence subject to change in
+             future releases without a deprecation period.
 
 
 Application layer specification fields
@@ -182,7 +182,7 @@ base runtime also becomes the base runtime for the application layer using those
 .. _layer-names:
 
 Layer names and versioning
-==========================
+--------------------------
 
 Regardless of how a layer is versioned, the layer name is used directly
 (with no additional prefix or suffix) when referring to the layer as a

pr-preview/pr-82/file-formats/index.html

@@ -426,6 +426,12 @@ <h3>Framework layer specification fields<a class="headerlink" href="#framework-l
 runtime layer in (for
 example, to update to new OpenSSL versions or CPython maintenance releases),
 without needing to republish the upper layers that use that base runtime.</p>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>The current handling of the <code class="docutils literal notranslate"><span class="pre">runtime_name</span></code> field in the layer
+metadata is highly questionable, and hence subject to change in
+future releases without a deprecation period.</p>
+</div>
 </section>
 <section id="application-layer-specification-fields">
 <h3>Application layer specification fields<a class="headerlink" href="#application-layer-specification-fields" title="Link to this heading">¶</a></h3>
@@ -450,9 +456,8 @@ <h3>Application layer specification fields<a class="headerlink" href="#applicati
 field for published artifacts).</p>
 </div>
 </section>
-</section>
 <section id="layer-names-and-versioning">
-<span id="layer-names"></span><h2>Layer names and versioning<a class="headerlink" href="#layer-names-and-versioning" title="Link to this heading">¶</a></h2>
+<span id="layer-names"></span><h3>Layer names and versioning<a class="headerlink" href="#layer-names-and-versioning" title="Link to this heading">¶</a></h3>
 <p>Regardless of how a layer is versioned, the layer name is used directly
 (with no additional prefix or suffix) when referring to the layer as a
 dependency in another layer specification.</p>
@@ -487,6 +492,7 @@ <h3>Application layer specification fields<a class="headerlink" href="#applicati
 between explicit versioning, implicit versioning, and leaving layers unversioned.</p>
 </div>
 </section>
+</section>
 <section id="locked-layer-requirements">
 <span id="layer-requirements"></span><h2>Locked layer requirements<a class="headerlink" href="#locked-layer-requirements" title="Link to this heading">¶</a></h2>
 <div class="admonition note">
@@ -574,9 +580,9 @@ <h3>Application layer specification fields<a class="headerlink" href="#applicati
 <li><a class="reference internal" href="#runtime-layer-specification-fields">Runtime layer specification fields</a></li>
 <li><a class="reference internal" href="#framework-layer-specification-fields">Framework layer specification fields</a></li>
 <li><a class="reference internal" href="#application-layer-specification-fields">Application layer specification fields</a></li>
+<li><a class="reference internal" href="#layer-names-and-versioning">Layer names and versioning</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#layer-names-and-versioning">Layer names and versioning</a></li>
 <li><a class="reference internal" href="#locked-layer-requirements">Locked layer requirements</a></li>
 <li><a class="reference internal" href="#deployed-layer-configuration">Deployed layer configuration</a></li>
 <li><a class="reference internal" href="#published-layer-metadata">Published layer metadata</a></li>

pr-preview/pr-82/index.html

@@ -342,7 +342,6 @@ <h1>Virtual Environment Stacks<a class="headerlink" href="#virtual-environment-s
 <li class="toctree-l1"><a class="reference internal" href="file-formats/">Environment Stack File Formats</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="file-formats/#file-naming-and-formats">File naming and formats</a></li>
 <li class="toctree-l2"><a class="reference internal" href="file-formats/#defining-virtual-environment-stacks">Defining virtual environment stacks</a></li>
-<li class="toctree-l2"><a class="reference internal" href="file-formats/#layer-names-and-versioning">Layer names and versioning</a></li>
 <li class="toctree-l2"><a class="reference internal" href="file-formats/#locked-layer-requirements">Locked layer requirements</a></li>
 <li class="toctree-l2"><a class="reference internal" href="file-formats/#deployed-layer-configuration">Deployed layer configuration</a></li>
 <li class="toctree-l2"><a class="reference internal" href="file-formats/#published-layer-metadata">Published layer metadata</a></li>