Tweak docs (#240)

Author: BoD

Writerside/cfg/buildprofiles.xml

@@ -11,10 +11,9 @@
       <download-title>GitHub</download-title>
       <download-page>https://github.com/apollographql/apollo-kotlin-normalized-cache/</download-page>
       <showDownloadButton>true</showDownloadButton>
-      <enable-browser-edits>true</enable-browser-edits>
-      <browser-edits-url>https://github.com/apollographql/apollo-kotlin-normalized-cache/edit/main/Writerside/
-      </browser-edits-url>
+      <enable-contribution>false</enable-contribution>
       <custom-css>custom.css</custom-css>
+      <primary-color>#fc5200</primary-color>
     </variables>
   </build-profile>
 </buildprofiles>

Writerside/cfg/static/custom.css

@@ -1,3 +1,25 @@
 .link {
     border-color: inherit;
 }
+
+:root.theme-dark {
+    --wh-color-white: rgb(207 215 214);
+    --wh-color-bg-main: #13222a;
+    --wh-color-bg-main-dark: rgb(13 23 28);
+    --wh-color-accent-substrate-bg: #13222a;
+    --wh-color-border-default: rgb(37 66 80);
+}
+
+.app__footer {
+    display: none !important;
+}
+
+.app__header {
+    border-bottom: 1px solid;
+    border-bottom-color: var(--wh-color-border-default);
+}
+
+.sub-title__edit-info {
+    color: rgb(207 215 214 / 35%);
+
+}

Writerside/doc.tree

@@ -3,7 +3,7 @@
 
 <instance-profile
     id="doc"
-    name="apollo-kotlin-normalized-cache"
+    name="Apollo Kotlin Normalized Cache"
     start-page="welcome.md"
 >
 

Writerside/topics/migration-guide.md

@@ -3,13 +3,15 @@
 The Normalized Cache is now hosted in this dedicated repository and published at its own cadence and versioning scheme.
 
 The Normalized Cache in the [Apollo Kotlin main repository](https://github.com/apollographql/apollo-kotlin) will not receive new features - they
-are added here instead. In the future, the main repository Normalized Cache will be deprecated and then removed.
+are added here instead. In the future, the main repository version will be deprecated and then removed.
 
 This guide highlights the main differences between this library and the main repository version, and how to migrate from it.
 
 ## Artifacts and packages
 
-To use this library, update the dependencies to your project:
+The Normalized Cache requires Apollo Kotlin ***v4.3.0*** or later.
+
+First, update the dependencies to your project:
 
 ```kotlin
 // build.gradle.kts
@@ -47,7 +49,7 @@ Configure the [compiler plugin](compiler-plugin.md) in your `build.gradle.kts` f
 ```kotlin
 apollo {
   service("service") {
-    packageName.set("com.example")
+    // ...
 
     // Add this
     plugin("com.apollographql.cache:normalized-cache-apollo-compiler-plugin:%latest_version%") {
@@ -61,7 +63,7 @@ apollo {
 // For Apollo Kotlin v5 and later
 apollo {
   service("service") {
-    packageName.set("com.example")
+    // ...
 
     // Add this
     plugin("com.apollographql.cache:normalized-cache-apollo-compiler-plugin:%latest_version%")

Writerside/topics/welcome.md

@@ -17,7 +17,7 @@ Compared to the previous version, this library brings:
 - SQL cache improved performance
 
 The Normalized Cache in the [Apollo Kotlin main repository](https://github.com/apollographql/apollo-kotlin) will not receive new features - they
-are added here instead. In the future, the main repository Normalized Cache will be deprecated and then removed.
+are added here instead. In the future, the main repository version will be deprecated and then removed.
 
 ## Use in your project
 
@@ -26,7 +26,7 @@ are added here instead. In the future, the main repository Normalized Cache will
 
 {style="warning"}
 
-The Normalized Cache requires Apollo Kotlin v4.3.0 or later.
+The Normalized Cache requires Apollo Kotlin ***v4.3.0*** or later.
 
 1. Add the dependencies to your project
 
@@ -56,5 +56,17 @@ apollo {
   }
 }
 ```
+<code-block lang="kotlin" collapsible="true" collapsed-title="For Apollo Kotlin v5+">
+// For Apollo Kotlin v5 and later
+apollo {
+  service("service") {
+    // ...
+
+    // Add this
+    plugin("com.apollographql.cache:normalized-cache-apollo-compiler-plugin:%latest_version%")
+    pluginArgument("com.apollographql.cache.packageName", packageName.get())
+}
+}
+</code-block>
 
-If you're already using the main repository Normalized Cache, please consult the [migration guide](migration-guide.md). 
+If you're already using the main repository version, please consult the [migration guide](migration-guide.md).