refactor(docs): URL structure

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"),

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,19 +30,19 @@ 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,
     ],
     [
       '@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',
             },
           ],
         },

subprojects/docs/src/docs-api/javadoc.md → 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
 

subprojects/docs/src/docs/docker.md → 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
 

subprojects/docs/src/docs/language/_category_.yml → 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!

subprojects/docs/src/docs/tutorials/_category_.yml → 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!

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',