Docs set 1

buildSrc/src/main/kotlin/BuildExtensions.kt

@@ -152,6 +152,9 @@ val PluginDependenciesSpec.protobuf: PluginDependencySpec
 val PluginDependenciesSpec.prototap: PluginDependencySpec
     get() = id(ProtoTap.gradlePluginId).version(ProtoTap.version)
 
+val PluginDependenciesSpec.`spine-compiler`: PluginDependencySpec
+    get() = id(Compiler.pluginId).version(Compiler.version)
+
 val PluginDependenciesSpec.`gradle-doctor`: PluginDependencySpec
     get() = id(GradleDoctor.pluginId).version(GradleDoctor.version)
 

buildSrc/src/main/kotlin/io/spine/dependency/local/CoreJvmCompiler.kt

@@ -46,12 +46,12 @@ object CoreJvmCompiler {
     /**
      * The version used to in the build classpath.
      */
-    const val dogfoodingVersion = "2.0.0-SNAPSHOT.050"
+    const val dogfoodingVersion = "2.0.0-SNAPSHOT.051"
 
     /**
      * The version to be used for integration tests.
      */
-    const val version = "2.0.0-SNAPSHOT.050"
+    const val version = "2.0.0-SNAPSHOT.051"
 
     /**
      * The ID of the Gradle plugin.

buildSrc/src/main/kotlin/io/spine/dependency/local/Validation.kt

@@ -36,7 +36,7 @@ object Validation {
     /**
      * The version of the Validation library artifacts.
      */
-    const val version = "2.0.0-SNAPSHOT.392"
+    const val version = "2.0.0-SNAPSHOT.393"
 
     /**
      * The last version of Validation compatible with ProtoData.

docs/STRUCTURE.md

@@ -0,0 +1,175 @@
+# Structuring repositories for Hugo documentation using Go modules
+
+This document describes the **recommended repository layout and Hugo
+Module mount strategy** for building modular documentation where:
+
+-   The **main site** assembles documentation from multiple repositories
+-   Each framework/library keeps **all documentation isolated under
+    `docs/`**
+-   Hugo Modules (Go modules) are used for versioning and composition
+
+------------------------------------------------------------------------
+
+## High-level architecture
+
+-   **Main site repository**
+    -   Hugo site that assembles all documentation
+    -   Imports documentation modules only
+-   **Documentation provider repositories** (framework, libraries)
+    -   Each repo exposes its documentation as a **Hugo Module**
+    -   All doc-related files live under `docs/`
+
+Each `docs/` directory is:
+ - a **Go module root** (`go.mod`)
+ - a **Hugo project root** (`hugo.yaml`)
+
+------------------------------------------------------------------------
+
+## Main site repository
+
+    main-site/
+      go.mod
+      hugo.yaml
+      content/
+      layouts/
+      assets/
+
+### hugo.yaml
+
+``` yaml
+module:
+  imports:
+    - path: github.com/your-org/framework/docs
+    - path: github.com/your-org/lib-foo/docs
+    - path: github.com/your-org/lib-bar/docs
+```
+
+------------------------------------------------------------------------
+
+## Framework documentation repository
+
+    framework/
+      docs/
+        go.mod
+        go.sum
+        hugo.yaml
+        content/
+          framework/
+            _index.md
+        layouts/
+        assets/
+
+### docs/go.mod
+
+``` go
+module github.com/your-org/framework/docs
+go 1.22
+```
+
+### docs/hugo.yaml
+
+``` yaml
+module:
+  mounts:
+    - source: content
+      target: content/framework
+    - source: layouts
+      target: layouts
+    - source: assets
+      target: assets
+```
+
+------------------------------------------------------------------------
+
+## Library documentation repository (example: lib-foo)
+
+    lib-foo/
+      docs/
+        go.mod
+        hugo.yaml
+        content/
+          libraries/
+            foo/
+              _index.md
+
+### docs/go.mod
+
+``` go
+module github.com/your-org/lib-foo/docs
+go 1.22
+```
+
+### docs/hugo.yaml
+
+``` yaml
+module:
+  mounts:
+    - source: content
+      target: content/libraries/foo
+    - source: layouts
+      target: layouts
+    - source: assets
+      target: assets
+```
+
+------------------------------------------------------------------------
+
+## Content conventions
+ *	Always mount into namespaced sections:
+ *	`content/framework/...`
+ *	`content/libraries/<libname>/...`
+ *	Use `_index.md` at section roots to create proper landing pages
+ *	Avoid mounting directly to `content/` without a subdirectory
+
+------------------------------------------------------------------------
+
+## Optional: shared documentation UI module
+
+For shared shortcodes, partials, and styling:
+
+    docs-ui/
+    go.mod
+    hugo.yaml
+    layouts/
+    shortcodes/
+    partials/
+    assets/
+
+**docs-ui/hugo.yaml:**
+
+```yaml
+module:
+  mounts:
+  - source: layouts
+    target: layouts
+  - source: assets
+    target: assets
+```
+Import this module before content modules in the main site.
+
+------------------------------------------------------------------------
+
+## Local development
+
+Run documentation standalone from a repo:
+
+    cd framework
+    hugo server --source docs
+
+For multi-repo development, consider a go.work file to use local checkouts instead of remote module versions.
+
+------------------------------------------------------------------------
+
+## Key rules to follow
+ * docs/ is the only Hugo + Go module root in doc-providing repos
+ * Each docs module defines its own mounts
+ * The main site only imports modules
+ * Mount targets must be unique and namespaced
+ * Commit both go.mod and go.sum for reproducible builds
+
+------------------------------------------------------------------------
+
+## References
+ * Hugo Modules overview: https://gohugo.io/hugo-modules/
+ * Hugo module configuration: https://gohugo.io/configuration/module/
+ * Go modules reference: https://go.dev/ref/mod

docs/_code/first-model/build.gradle.kts

@@ -0,0 +1,64 @@
+import io.spine.dependency.lib.Guava
+import io.spine.dependency.local.Base
+import io.spine.gradle.repo.standardToSpineSdk
+
+/*
+ * Copyright 2026, TeamDev. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+buildscript {
+    standardSpineSdkRepositories()
+    dependencies {
+        classpath(io.spine.dependency.local.Compiler.pluginLib)
+    }
+}
+
+plugins {
+    `java-library`
+    kotlin("jvm")
+    id("com.google.protobuf")
+    `spine-compiler`
+    id("io.spine.validation")
+}
+
+group = "io.spine.docs"
+version = "2.0.0"
+
+repositories {
+    mavenLocal()
+    standardToSpineSdk()
+}
+
+dependencies {
+    testImplementation(kotlin("test"))
+}
+
+kotlin {
+    jvmToolchain(17)
+}
+
+tasks.test {
+    useJUnitPlatform()
+}

docs/_code/first-model/buildSrc

@@ -0,0 +1 @@
+/Users/sanders/Projects/Spine/validation/buildSrc

docs/_code/first-model/gradle.properties

@@ -0,0 +1 @@
+/Users/sanders/Projects/Spine/validation/gradle.properties