feat(docs): Added new documentation site

resolves #55

Author: ocni-dtu

.github/workflows/build_rust.yaml

@@ -18,17 +18,20 @@ jobs:
       - name: Run Tests
         run: cargo test --target x86_64-unknown-linux-gnu
 
-      - name: Run Export Schemas
+      - name: Export LCAx Schema
         run: cargo run --target x86_64-unknown-linux-gnu --package lcax --bin export-schema > lcax.schema.json
 
+      - name: Export Validation Schema
+        run: cargo run --target x86_64-unknown-linux-gnu --package lcax_validation --bin export-schema > validation.schema.json
+
       - name: Upload JSON Schema
         uses: actions/upload-artifact@v4
         with:
           name: json-schema
           path: 'lcax.schema.json'
 
-      - name: Upload Rust Schema
+      - name: Upload Validation Schema
         uses: actions/upload-artifact@v4
         with:
-          name: rust-schema
-          path: 'modules/models/src/project.rs'
+          name: validation-schema
+          path: 'validation.schema.json'

.github/workflows/cicd.yaml

@@ -4,11 +4,11 @@ on:
   push:
     branches:
       - main
-      - v3.0
+      - v3.x
   pull_request:
     branches:
       - main
-      - v3.0
+      - v3.x
   workflow_dispatch:
 
 permissions:

.github/workflows/create_release.yaml

@@ -36,14 +36,9 @@ jobs:
 
       - uses: actions/download-artifact@v4
         with:
-          name: rust-schema
+          name: validation-schema
           path: artifacts
 #
-#      - uses: actions/download-artifact@v4
-#        with:
-#          name: csharp-schema
-#          path: artifacts
-
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:

.github/workflows/release_docs.yaml

@@ -21,13 +21,13 @@ jobs:
 
       - uses: actions/download-artifact@v4
         with:
-          name: rust-schema
-          path: docs/src/content/code/rust
+          name: validation-schema
+          path: docs/src/content/code
 
       - uses: actions/download-artifact@v4
         with:
           name: changelog
-          path: .
+          path: docs/src/content/reference
 
       - name: Set up Node
         uses: actions/setup-node@v4
@@ -38,12 +38,11 @@ jobs:
         working-directory: docs
         run: npm ci
 
-      - name: Construct Changelog
-        run: cat CHANGELOG.md >> docs/src/content/docs/reference/changelog.md
-
       - name: Build Docs
         working-directory: docs
         run: npm run build
+        env:
+          DOMAIN: docs.lcax.org
 
       - name: Upload artifact for deployment job
         if: github.event_name != 'pull_request'

.gitignore

@@ -15,6 +15,7 @@ downloads/
 eggs/
 .eggs/
 lib/
+!docs/app/lib/
 lib64/
 parts/
 sdist/
@@ -184,3 +185,16 @@ package-lock.json
 /packages/csharp/lcax/bin/
 /packages/csharp/lcax/obj/
 /modules/convert/tests/br_standard/datafixtures/914a0b0b-4b7f-498f-9349-16cf0d644766.xlsx
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+/docs/dist
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+/docs/.next/

.releaserc.yaml

@@ -1,6 +1,6 @@
 branches:
   - "main"
-  - name: "v3.0"
+  - name: "v3.x"
     prerelease: beta
 
 preset: "conventionalcommits"
@@ -37,10 +37,7 @@ plugins:
   - - "@semantic-release/github"
     - assets:
         - { path: 'artifacts/lcax.schema.json', label: 'LCAx JSON Schema' }
-#        - { path: 'packages/python/src/lcax/pydantic.py', label: 'LCAx Python Classes' }
-#        - { path: 'artifacts/lcax.d.ts', label: 'LCAx TypeScript Declarations' }
-        - { path: 'artifacts/project.rs', label: 'LCAx Rust Structs' }
-#        - { path: 'artifacts/lcax.cs', label: 'LCAx C# Classes' }
+        - { path: 'artifacts/validation.schema.json', label: 'LCAx Validation Schema' }
   - - "@semantic-release/git"
     - assets:
         - "CHANGELOG.md"

docs/.gitignore

@@ -0,0 +1,9 @@
+{
+  "semi": false,
+  "tabWidth": 2,
+  "printWidth": 120,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "jsxSingleQuote": true,
+  "bracketSpacing": true
+}

docs/.prettierrc

@@ -1,55 +1,36 @@
-# Starlight Starter Kit: Basics
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
 
-[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+## Getting Started
 
-```
-npm create astro@latest -- --template starlight
-```
-
-[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics)
-[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/starlight/tree/main/examples/basics)
-[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/withastro/starlight&create_from_path=examples/basics)
-[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fwithastro%2Fstarlight%2Ftree%2Fmain%2Fexamples%2Fbasics&project-name=my-starlight-docs&repository-name=my-starlight-docs)
-
-> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+First, run the development server:
 
-## 🚀 Project Structure
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
 
-Inside of your Astro + Starlight project, you'll see the following folders and files:
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
 
-```
-.
-├── public/
-├── src/
-│   ├── assets/
-│   ├── content/
-│   │   ├── docs/
-│   │   └── content.config.ts
-│   └── env.d.ts
-├── astro.config.mjs
-├── package.json
-└── tsconfig.json
-```
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
 
-Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
 
-Images can be added to `src/assets/` and embedded in Markdown with a relative link.
+## Learn More
 
-Static assets, like favicons, can be placed in the `public/` directory.
+To learn more about Next.js, take a look at the following resources:
 
-## 🧞 Commands
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
 
-All commands are run from the root of the project, from a terminal:
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
 
-| Command                   | Action                                           |
-| :------------------------ | :----------------------------------------------- |
-| `npm install`             | Installs dependencies                            |
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
-| `npm run build`           | Build your production site to `./dist/`          |
-| `npm run preview`         | Preview your build locally, before deploying     |
-| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
+## Deploy on Vercel
 
-## 👀 Want to learn more?
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
 
-Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.