From 8161c4a1e8fafc564fe32c309e16098a58f6d8e7 Mon Sep 17 00:00:00 2001
From: Simon Binder <oss@simonbinder.eu>
Date: Sun, 10 Oct 2021 20:07:14 +0200
Subject: [PATCH] Add rename hint to all doc pages

---
 docs/lib/_style.scss                    |  5 ++++
 docs/pages/docs/name.md                 | 14 ++++++----
 docs/templates/layouts/docs/baseof.html | 34 +++++++++++++++++++++++++
 3 files changed, 48 insertions(+), 5 deletions(-)
 create mode 100644 docs/templates/layouts/docs/baseof.html
diff --git a/docs/lib/_style.scss b/docs/lib/_style.scss
index 5bd46222..ff54bca8 100644
--- a/docs/lib/_style.scss
+++ b/docs/lib/_style.scss
@@ -1,2 +1,7 @@
 @import 'variables.scss';
 @import '_highlight.scss';
+
+.renamed {
+   padding: 10px;
+   background-color: rgba(0, 0, 0, 0.08);
+}
diff --git a/docs/pages/docs/name.md b/docs/pages/docs/name.md
index e8e9d6c4..30190fb3 100644
--- a/docs/pages/docs/name.md
+++ b/docs/pages/docs/name.md
@@ -7,13 +7,17 @@ template: layouts/docs/single
 path: /name
 ---
 
-Moor has been renamed to `drift`. The reason for this is that, in some parts of the world, moor is used as a derogatory term.
-I have not been aware of this when starting this project, but this name does not reflect the inclusivity of the Dart and Flutter communities.
-Despite the associated effort, I believe that renaming the project is the right decision.
+Moor has been renamed to `drift`. The reason for this is that, in some parts of the world, moor may be used as a derogatery term.
+I have not been aware of this when starting this project, but we believe that the current name does not reflect the inclusivity of the Dart and Flutter communities.
+Despite the associated effort, renaming the project is the right decision.
 Thank you for your understanding!
 
+Until version `5.0.0`, the current `moor` and `moor_generator` packages will continue to work - __no urgent action is necessary__.
+All features and fixes to the new `drift` packages will be mirrored in `moor` as well.
+At the next breaking release, the `moor` set of packages will be discontinued in favor of `drift` and `drift_dev`.
+
 This page describes how to migrate from the old `moor` package to the new `drift` package.
-An automatic tool can make all necessary changes, and this is the recommended approach for all users.
+This process can be automated, and we hope that the migration is a matter of minutes for you.
 In case of issues with the tool, this page also describes how to manually migrate to the new `drift` packages.
 
 ## Automatic migration
@@ -127,4 +131,4 @@ When configuring moor builders for [options]({{ 'Advanced Features/builder_optio
 | `moor_generator\|moor_generator`            | `drift_dev\|drift_dev`         |
 | `moor_generator`                            | `drift_dev`                    |
 | `moor_generator\|moor_generator_not_shared` | `drift_dev\|not_shared`        |
-| `moor_generator\|moor_cleanup`              | `drift_dev\|cleanup`           |
\ No newline at end of file
+| `moor_generator\|moor_cleanup`              | `drift_dev\|cleanup`           |
diff --git a/docs/templates/layouts/docs/baseof.html b/docs/templates/layouts/docs/baseof.html
new file mode 100644
index 00000000..349d17ab
--- /dev/null
+++ b/docs/templates/layouts/docs/baseof.html
@@ -0,0 +1,34 @@
+<!doctype html>
+<html lang="{{ site.language }}" class="no-js">
+  <head>
+    {% include "partials/head" %}
+  </head>
+  <body class="td-{{ kind }}">
+    <header>
+      {% include "partials/navbar" %}
+    </header>
+    <div class="container-fluid td-outer">
+      <div class="td-main">
+        <div class="row flex-xl-nowrap">
+          <div class="col-12 col-md-3 col-xl-2 td-sidebar d-print-none">
+            {% include "partials/sidebar" %}
+          </div>
+            <div class="d-none d-xl-block col-xl-2 td-toc d-print-none">
+              {% include "partials/toc" %}
+            </div>
+            <main class="col-12 col-md-9 col-xl-8 pl-md-5" role="main">
+              {% if page.path != '/name' %}
+              <div class="renamed">
+                <b>Important notice: </b>Moor has been renamed to Drift.
+                Learn more <a href="{{ '/name/' | relUrl }}">here</a>.
+              </div>
+              {% endif %}
+              {% include "partials/breadcrumb" %}
+              {{ main }}
+            </main>
+          </div>
+        </div>
+      {% include "partials/footer" %}
+    </div>
+  </body>
+</html>
