Eliminate duplicate sidebar.yml files, generate it when building docs using sidebar.reference.yml and sidebar.nightly.template.yml.

Author: WojciechMazur

docs/_layouts/static-site-main.html

@@ -4,17 +4,7 @@
 
 <div class="site-container">
   <div id="site-header"></div>
-  {% if page.nightlyOf %}
-  <aside class="warning">
-    <div class='icon'></div>
-    <div class='content'>
-    This is a nightly documentation. The content of this page may not be
-    consistent with the current stable version of language. Click
-    <a href="{{ page.nightlyOf }}">here</a> to find the stable version of this
-    page.
-    </div>
-  </aside>
-  {% endif %} {{ content }}
+  {{ content }}
   <div class="divider" />
   <nav class="arrow-navigation" aria-label="Page navigation">
     {% if page.previous %}

docs/sidebar.nightly.template.yml

@@ -0,0 +1,63 @@
+index: index.md
+subsection:
+  - title: Reference
+    directory: docs/reference
+    # Embed sidebar.reference.yml, performed by `generateScalaDocumentation` sbt task
+  - title: Contributing
+    directory: docs/contributing
+    index: contributing/index.md
+    subsection:
+      - page: contributing/getting-started.md
+      - page: contributing/setting-up-your-ide.md
+      - index: contributing/issues/diagnosing-your-issue.md
+        subsection:
+          - page: contributing/issues/reproduce.md
+          - page: contributing/issues/cause.md
+          - page: contributing/issues/areas.md
+      - index: contributing/debugging/debugging.md
+        subsection:
+          - page: contributing/debugging/ide-debugging.md
+          - page: contributing/debugging/inspection.md
+          - page: contributing/debugging/other-debugging.md
+      - page: contributing/testing.md
+      - page: contributing/scaladoc.md
+      - page: contributing/community-build.md
+      - page: contributing/sending-in-a-pr.md
+      - page: contributing/cheatsheet.md
+      - title: Procedures
+        directory: procedures
+        index: contributing/procedures/index.md
+        subsection:
+          - page: contributing/procedures/release.md
+          - page: contributing/procedures/vulpix.md
+      - title: High Level Architecture
+        directory: architecture
+        index: contributing/architecture/index.md
+        subsection:
+          - page: contributing/architecture/lifecycle.md
+          - page: contributing/architecture/context.md
+          - page: contributing/architecture/phases.md
+          - page: contributing/architecture/types.md
+          - page: contributing/architecture/time.md
+          - page: contributing/architecture/symbols.md
+  - title: Internals
+    directory: docs/internals
+    index: internals/index.md
+    subsection:
+      - page: internals/backend.md
+      - page: internals/classpaths.md
+      - page: internals/contexts.md
+      - page: internals/dotc-scalac.md
+      - page: internals/higher-kinded-v2.md
+      - page: internals/overall-structure.md
+      - page: internals/explicit-nulls.md
+      - page: internals/periods.md
+      - page: internals/syntax.md
+      - page: internals/type-system.md
+      - page: internals/dotty-internals-1-notes.md
+      - page: internals/debug-macros.md
+      - page: internals/gadts.md
+      - page: internals/coverage.md
+      - page: internals/best-effort-compilation.md
+  - page: release-notes-0.1.2.md  # Referenced from https://www.scala-lang.org/blog/2017/05/31/first-dotty-milestone-release.html
+    hidden: true

project/resources/referenceReplacements/sidebar.yml renamed to docs/sidebar.reference.yml

@@ -28,12 +28,13 @@ subsection:
     directory: contextual
     subsection:
       - page: reference/contextual/givens.md
-      - page: reference/contextual/deferred-givens.md
-      - page: reference/contextual/more-givens.md
-      - page: reference/contextual/previous-givens.md
       - page: reference/contextual/using-clauses.md
       - page: reference/contextual/context-bounds.md
+      - page: reference/contextual/deferred-givens.md
       - page: reference/contextual/given-imports.md
+      - page: reference/contextual/more-givens.md
+      - page: reference/contextual/previous-givens.md
+        hidden: true
       - page: reference/contextual/extension-methods.md
       - page: reference/contextual/right-associative-extension-methods.md
       - page: reference/contextual/type-classes.md
@@ -54,10 +55,10 @@ subsection:
       - page: reference/metaprogramming/macros.md
       - page: reference/metaprogramming/macros-spec.md
         hidden: true
+      - page: reference/metaprogramming/simple-smp.md # description of a simplified metaprogramming language, this might not be the best place for it
       - page: reference/metaprogramming/staging.md
       - page: reference/metaprogramming/reflection.md
       - page: reference/metaprogramming/tasty-inspect.md
-      - page: reference/metaprogramming/simple-smp.md
   - title: Other New Features
     index: reference/other-new-features/other-new-features.md
     subsection:
@@ -67,6 +68,7 @@ subsection:
       - page: reference/other-new-features/export.md
       - page: reference/other-new-features/opaques.md
       - page: reference/other-new-features/opaques-details.md
+      - page: reference/other-new-features/named-tuples.md
       - page: reference/other-new-features/open-classes.md
       - page: reference/other-new-features/parameter-untupling.md
       - page: reference/other-new-features/parameter-untupling-spec.md
@@ -80,7 +82,9 @@ subsection:
       - page: reference/other-new-features/safe-initialization.md
       - page: reference/other-new-features/type-test.md
       - page: reference/other-new-features/experimental-defs.md
+      - page: reference/other-new-features/preview-defs.md
       - page: reference/other-new-features/binary-literals.md
+      - page: reference/other-new-features/toplevel-definitions.md
   - title: Other Changed Features
     directory: changed-features
     index: reference/changed-features/changed-features.md
@@ -118,7 +122,6 @@ subsection:
       - page: reference/dropped-features/type-projection.md
       - page: reference/dropped-features/do-while.md
       - page: reference/dropped-features/procedure-syntax.md
-      - page: reference/dropped-features/package-objects.md
       - page: reference/dropped-features/early-initializers.md
       - page: reference/dropped-features/class-shadowing.md
       - page: reference/dropped-features/class-shadowing-spec.md
@@ -133,6 +136,11 @@ subsection:
       - page: reference/dropped-features/nonlocal-returns.md
       - page: reference/dropped-features/this-qualifier.md
       - page: reference/dropped-features/wildcard-init.md
+  - title: Preview Features
+    directory: preview
+    index: reference/preview/overview.md
+    subsection:
+      - page: reference/preview/better-fors.md
   - title: Experimental Features
     directory: experimental
     index: reference/experimental/overview.md
@@ -149,10 +157,17 @@ subsection:
       - page: reference/experimental/numeric-literals.md
       - page: reference/experimental/explicit-nulls.md
       - page: reference/experimental/main-annotation.md
+      - page: reference/experimental/into.md
       - page: reference/experimental/cc.md
       - page: reference/experimental/cc-advanced.md
         hidden: true
+      - page: reference/experimental/purefuns.md
       - page: reference/experimental/tupled-function.md
+      - page: reference/experimental/modularity.md
+      - page: reference/experimental/typeclasses.md
+      - page: reference/experimental/runtimeChecked.md
+      - page: reference/experimental/unrolled-defs.md
+      - page: reference/experimental/package-object-values.md
   - page: reference/syntax.md
   - title: Language Versions
     index: reference/language-versions/language-versions.md