Merge pull request #58 from graphs4value/docs

Add documentation site with Docusaurus

.eslintrc.cjs

@@ -9,6 +9,7 @@ const path = require('node:path');
 // Allow the Codium ESLint plugin to find `tsconfig.json` from the repository root.
 const project = [
   path.join(__dirname, 'tsconfig.json'),
+  path.join(__dirname, 'subprojects/docs/tsconfig.json'),
   path.join(__dirname, 'subprojects/frontend/tsconfig.json'),
   path.join(__dirname, 'subprojects/frontend/tsconfig.node.json'),
   path.join(__dirname, 'subprojects/frontend/tsconfig.shared.json'),
@@ -48,8 +49,10 @@ module.exports = {
   ignorePatterns: [
     'build/**/*',
     'subprojects/*/build/**/*',
-    'subprojects/*/dev-dist/**/*',
-    'subprojects/*/src/**/*.typegen.ts',
+    'subprojects/docs/.docusaurus/**/*',
+    'subprojects/docs/.yarn/**/*',
+    'subprojects/frontend/dev-dist/**/*',
+    'subprojects/frontend/src/**/*.typegen.ts',
   ],
   rules: {
     // In typescript, some class methods implementing an inderface do not use `this`:
@@ -107,6 +110,13 @@ module.exports = {
         '@typescript-eslint/no-var-requires': 'off',
       },
     },
+    {
+      files: ['*.cts'],
+      rules: {
+        // Allow `import type` in CommonJS TypeScript modules.
+        'import/no-import-module-exports': 'off',
+      },
+    },
     {
       files: [
         '.eslintrc.cjs',
@@ -132,5 +142,21 @@ module.exports = {
         'no-process-env': 'off',
       },
     },
+    {
+      files: ['subprojects/docs/src/**/*'],
+      rules: {
+        'import/no-unresolved': [
+          'error',
+          {
+            ignore: [
+              // These imports are resolved by Docusaurus, not TypeScript.
+              '^@docusaurus/',
+              '^@theme/',
+              '^@theme-original/',
+            ],
+          },
+        ],
+      },
+    },
   ],
 };

.gitattributes

@@ -1,10 +1,11 @@
-# SPDX-FileCopyrightText: 2021-2023 The Refinery Authors
+# SPDX-FileCopyrightText: 2021-2024 The Refinery Authors
 #
 # SPDX-License-Identifier: CC0-1.0
 
 .yarn/releases/** binary
 .yarn/plugins/** binary
 *.cjs eol=lf
+*.cts eol=lf
 *.css eol=lf
 *.js eol=lf
 *.json eol=lf

.gitignore

@@ -21,10 +21,8 @@
 !.yarn/versions
 bin/
 build/
-dev-dist/
 emf-gen/
 node_modules/
-*.typegen.ts
 xtend-gen/
 *.xtendbin
 xtext-gen/