refactor(docs): URL structure

20 files changed, 22 insertions, 22 deletions

diff --git a/subprojects/docs/build.gradle.kts b/subprojects/docs/build.gradle.kts
index 0c80e23a..e559ed3e 100644
--- a/subprojects/docs/build.gradle.kts
+++ b/subprojects/docs/build.gradle.kts
@@ -50,7 +50,7 @@ val docusaurusOutputDir = layout.buildDirectory.dir("docusaurus")
 
 val javadocsDir = layout.buildDirectory.dir("javadocs")
 
-val javadocsDocsDir = javadocsDir.map { root -> root.dir("api/javadoc") }
+val javadocsDocsDir = javadocsDir.map { root -> root.dir("develop/javadoc") }
 
 val configFiles: FileCollection = files(
         rootProject.file("yarn.lock"),
diff --git a/subprojects/docs/docusaurus.config.ts b/subprojects/docs/docusaurus.config.ts
index 47bf605e..00ef21b5 100644
--- a/subprojects/docs/docusaurus.config.ts
+++ b/subprojects/docs/docusaurus.config.ts
@@ -21,7 +21,6 @@ const markdownOptions = {
 export default {
   title: 'Refinery',
   tagline: 'An efficient graph solver for generating well-formed models',
-  titleDelimiter: '⚗️',
   url: 'https://refinery.tools',
   baseUrl: '/',
   baseUrlIssueBanner: false,
@@ -31,9 +30,9 @@ export default {
     [
       '@docusaurus/plugin-content-docs',
       {
-        id: 'docs',
-        path: 'src/docs',
-        routeBasePath: '/docs',
+        id: 'learn',
+        path: 'src/learn',
+        routeBasePath: '/learn',
         sidebarPath: undefined,
         ...markdownOptions,
       } satisfies DocsOptions,
@@ -41,9 +40,9 @@ export default {
     [
       '@docusaurus/plugin-content-docs',
       {
-        id: 'api',
-        path: 'src/docs-api',
-        routeBasePath: '/api',
+        id: 'develop',
+        path: 'src/develop',
+        routeBasePath: '/develop',
         sidebarPath: undefined,
         ...markdownOptions,
       } satisfies DocsOptions,
@@ -81,11 +80,11 @@ export default {
       items: [
         {
           label: 'Learn',
-          to: '/docs',
+          to: '/learn',
         },
         {
           label: 'Develop',
-          to: '/api',
+          to: '/develop',
         },
         {
           label: 'GitHub',
@@ -107,19 +106,19 @@ export default {
           items: [
             {
               label: 'Introduction',
-              to: '/docs',
+              to: '/learn',
             },
             {
               label: 'Tutorials',
-              to: '/docs/category/tutorials',
+              to: '/learn/tutorials',
             },
             {
               label: 'Langauge reference',
-              to: '/docs/category/language',
+              to: '/learn/language',
             },
             {
               label: 'Run in Docker',
-              to: '/docs/docker',
+              to: '/learn/docker',
             },
           ],
         },
@@ -128,15 +127,15 @@ export default {
           items: [
             {
               label: 'Programming guide',
-              to: '/api',
+              to: '/develop',
             },
             {
               label: 'Contributing',
-              to: '/api/contributing',
+              to: '/develop/contributing',
             },
             {
               label: 'Javadoc',
-              to: '/api/javadoc',
+              to: '/develop/javadoc',
             },
           ],
         },
diff --git a/subprojects/docs/src/docs-api/contributing.md b/subprojects/docs/src/develop/contributing.md
index 4a135b81..4a135b81 100644
--- a/subprojects/docs/src/docs-api/contributing.md
+++ b/subprojects/docs/src/develop/contributing.md
diff --git a/subprojects/docs/src/docs-api/index.md b/subprojects/docs/src/develop/index.md
index 4537889e..4537889e 100644
--- a/subprojects/docs/src/docs-api/index.md
+++ b/subprojects/docs/src/develop/index.md
diff --git a/subprojects/docs/src/docs-api/javadoc.md b/subprojects/docs/src/develop/javadoc.md
index 7e39b9b9..225e9de0 100644
--- a/subprojects/docs/src/docs-api/javadoc.md
+++ b/subprojects/docs/src/develop/javadoc.md
@@ -7,7 +7,7 @@ sidebar_position: 999
 
 # Javadoc
 
-Here you can find API documentation for Refinery components automatically generated by Javadoc. We recommend reading the [Programming guide](/api) first to understand how to use these components.
+Here you can find API documentation for Refinery components automatically generated by Javadoc. We recommend reading the [Programming guide](/develop) first to understand how to use these components.
 
 # Refinery
 
diff --git a/subprojects/docs/src/docs/docker.md b/subprojects/docs/src/learn/docker.md
index c61c1457..0df87da8 100644
--- a/subprojects/docs/src/docs/docker.md
+++ b/subprojects/docs/src/learn/docker.md
@@ -28,7 +28,7 @@ docker run --rm -it -p 8888:8888 ghcr.io/graphs4value/refinery
 
 Once Docker pulls and starts the container, you can navigate to http://localhost:8888 to open the model generation interface and start editing.
 
-Alternatively, you can follow the [instructions to set up a local development environment](/api/contributing) and compile and run Refinery from source.
+Alternatively, you can follow the [instructions to set up a local development environment](/develop/contributing) and compile and run Refinery from source.
 
 ## Updating
 
diff --git a/subprojects/docs/src/docs/index.md b/subprojects/docs/src/learn/index.md
index bb28df57..bb28df57 100644
--- a/subprojects/docs/src/docs/index.md
+++ b/subprojects/docs/src/learn/index.md
diff --git a/subprojects/docs/src/docs/language/_category_.yml b/subprojects/docs/src/learn/language/_category_.yml
index 7060edf3..f5a6f896 100644
--- a/subprojects/docs/src/docs/language/_category_.yml
+++ b/subprojects/docs/src/learn/language/_category_.yml
@@ -6,5 +6,5 @@ position: 2
 label: Language reference
 link:
   type: generated-index
-  slug: /category/language
+  slug: /language
   description: Learn more about the Refinery partial modeling language!
diff --git a/subprojects/docs/src/docs/language/classes.md b/subprojects/docs/src/learn/language/classes.md
index 7278dc35..7278dc35 100644
--- a/subprojects/docs/src/docs/language/classes.md
+++ b/subprojects/docs/src/learn/language/classes.md
diff --git a/subprojects/docs/src/docs/tutorials/_category_.yml b/subprojects/docs/src/learn/tutorials/_category_.yml
index 25a06d98..adf8293f 100644
--- a/subprojects/docs/src/docs/tutorials/_category_.yml
+++ b/subprojects/docs/src/learn/tutorials/_category_.yml
@@ -6,5 +6,6 @@ position: 1
 label: Tutorials
 link:
   type: generated-index
+  slug: /tutorials
   title: Tutorial overview
   description: Try Refinery in practical partial modeling challenges!
diff --git a/subprojects/docs/src/docs/tutorials/file-system/fig1.png b/subprojects/docs/src/learn/tutorials/file-system/fig1.png
index da30af3c..da30af3c 100644
--- a/subprojects/docs/src/docs/tutorials/file-system/fig1.png
+++ b/subprojects/docs/src/learn/tutorials/file-system/fig1.png
diff --git a/subprojects/docs/src/docs/tutorials/file-system/fig1.png.license b/subprojects/docs/src/learn/tutorials/file-system/fig1.png.license
index ff75bc7c..ff75bc7c 100644
--- a/subprojects/docs/src/docs/tutorials/file-system/fig1.png.license
+++ b/subprojects/docs/src/learn/tutorials/file-system/fig1.png.license
diff --git a/subprojects/docs/src/docs/tutorials/file-system/fig2.png b/subprojects/docs/src/learn/tutorials/file-system/fig2.png
index f42e3d3e..f42e3d3e 100644
--- a/subprojects/docs/src/docs/tutorials/file-system/fig2.png
+++ b/subprojects/docs/src/learn/tutorials/file-system/fig2.png
diff --git a/subprojects/docs/src/docs/tutorials/file-system/fig2.png.license b/subprojects/docs/src/learn/tutorials/file-system/fig2.png.license
index ff75bc7c..ff75bc7c 100644
--- a/subprojects/docs/src/docs/tutorials/file-system/fig2.png.license
+++ b/subprojects/docs/src/learn/tutorials/file-system/fig2.png.license
diff --git a/subprojects/docs/src/docs/tutorials/file-system/fig3.png b/subprojects/docs/src/learn/tutorials/file-system/fig3.png
index 9506417a..9506417a 100644
--- a/subprojects/docs/src/docs/tutorials/file-system/fig3.png
+++ b/subprojects/docs/src/learn/tutorials/file-system/fig3.png
diff --git a/subprojects/docs/src/docs/tutorials/file-system/fig3.png.license b/subprojects/docs/src/learn/tutorials/file-system/fig3.png.license
index ff75bc7c..ff75bc7c 100644
--- a/subprojects/docs/src/docs/tutorials/file-system/fig3.png.license
+++ b/subprojects/docs/src/learn/tutorials/file-system/fig3.png.license
diff --git a/subprojects/docs/src/docs/tutorials/file-system/fig4.png b/subprojects/docs/src/learn/tutorials/file-system/fig4.png
index cc012f24..cc012f24 100644
--- a/subprojects/docs/src/docs/tutorials/file-system/fig4.png
+++ b/subprojects/docs/src/learn/tutorials/file-system/fig4.png
diff --git a/subprojects/docs/src/docs/tutorials/file-system/fig4.png.license b/subprojects/docs/src/learn/tutorials/file-system/fig4.png.license
index ff75bc7c..ff75bc7c 100644
--- a/subprojects/docs/src/docs/tutorials/file-system/fig4.png.license
+++ b/subprojects/docs/src/learn/tutorials/file-system/fig4.png.license
diff --git a/subprojects/docs/src/docs/tutorials/file-system/index.md b/subprojects/docs/src/learn/tutorials/file-system/index.md
index 1d15512f..1d15512f 100644
--- a/subprojects/docs/src/docs/tutorials/file-system/index.md
+++ b/subprojects/docs/src/learn/tutorials/file-system/index.md
diff --git a/subprojects/docs/src/pages/index.tsx b/subprojects/docs/src/pages/index.tsx
index 25884336..713223c2 100644
--- a/subprojects/docs/src/pages/index.tsx
+++ b/subprojects/docs/src/pages/index.tsx
@@ -34,7 +34,7 @@ function Hero() {
             Try online
           </Link>
           <Link
-            to="/docs/docker"
+            to="/learn/docker"
             className={clsx(
               'button',
               'button--lg',
@@ -45,7 +45,7 @@ function Hero() {
             Try in Docker
           </Link>
           <Link
-            to="/docs/tutorials/file-system"
+            to="/learn/tutorials/file-system"
             className={clsx(
               'button',
               'button--lg',