wip

Author: edulix

.gitignore

@@ -6,3 +6,5 @@ results.log
 
 .release_tool_cache/
 __pycache__/
+node_modules
+.docusaurus

.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+    "recommendations": [
+        "ms-python.python",
+        "ms-azuretools.vscode-docker",
+        "tamasfe.even-better-toml"
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
+    "python.formatting.provider": "black",
+    "editor.formatOnSave": true,
+    "files.exclude": {
+        "**/.git": true,
+        "**/.DS_Store": true,
+        "**/__pycache__": true,
+        "**/*.pyc": true
+    }
+}

.vscode/tasks.json

@@ -1,14 +1,62 @@
 {
     "version": "2.0.0",
     "tasks": [
+        // --- Release Tool (Docker) ---
         {
-            "label": "Docker: Build Image",
+            "label": "Tool: Build Docker Image",
             "type": "shell",
             "command": "docker build -t release-tool:local .",
             "group": {
                 "kind": "build",
                 "isDefault": true
             },
+            "presentation": {
+                "reveal": "always",
+                "panel": "shared"
+            },
+            "problemMatcher": []
+        },
+        // --- Release Tool (Python) ---
+        {
+            "label": "Tool: Run Tests",
+            "type": "shell",
+            "command": "poetry run pytest",
+            "group": "test",
+            "presentation": {
+                "reveal": "always"
+            }
+        },
+        // --- Release Tool (Docusaurus) ---
+        {
+            "label": "Docs: Start Server",
+            "type": "shell",
+            "command": "cd docs && npm install && npm start",
+            "isBackground": true,
+            "problemMatcher": {
+                "owner": "typescript",
+                "pattern": "$tsc",
+                "background": {
+                    "activeOnStart": true,
+                    "beginsPattern": "Compiling...",
+                    "endsPattern": "Client compiled successfully"
+                }
+            },
+            "presentation": {
+                "group": "docs",
+                "reveal": "always"
+            }
+        },
+        {
+            "label": "Docs: Build Static Site",
+            "type": "shell",
+            "command": "cd docs && npm install && npm run build",
+            "group": "build"
+        },
+        // --- CI/CD ---
+        {
+            "label": "CI: Run Tests (act)",
+            "type": "shell",
+            "command": "act -j test --container-architecture linux/amd64",
             "problemMatcher": []
         }
     ]

docs/docusaurus.config.js

@@ -0,0 +1,84 @@
+// @ts-check
+// Note: type annotations allow type checking and IDEs autocompletion
+
+const { themes } = require('prism-react-renderer');
+const lightCodeTheme = themes.github;
+const darkCodeTheme = themes.dracula;
+
+/** @type {import('@docusaurus/types').Config} */
+const config = {
+    title: 'Release Tool',
+    tagline: 'Semantic Versioning & Release Management',
+    url: 'https://sequentech.github.io',
+    baseUrl: '/release-tool/',
+    onBrokenLinks: 'throw',
+    onBrokenMarkdownLinks: 'warn',
+    favicon: 'img/favicon.ico',
+    organizationName: 'sequentech',
+    projectName: 'release-tool',
+
+    presets: [
+        [
+            'classic',
+            /** @type {import('@docusaurus/preset-classic').Options} */
+            ({
+                docs: {
+                    path: '.',
+                    sidebarPath: require.resolve('./sidebars.js'),
+                    editUrl: 'https://github.com/sequentech/release-tool/tree/main/docs/',
+                    exclude: ['**/node_modules/**'],
+                },
+                theme: {
+                    customCss: require.resolve('./src/css/custom.css'),
+                },
+            }),
+        ],
+    ],
+
+    themeConfig:
+        /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
+        ({
+            colorMode: {
+                defaultMode: 'light',
+                disableSwitch: false,
+                respectPrefersColorScheme: true,
+            },
+            navbar: {
+                title: 'Release Tool',
+                items: [
+                    {
+                        type: 'doc',
+                        docId: 'intro',
+                        position: 'left',
+                        label: 'Docs',
+                    },
+                    {
+                        href: 'https://github.com/sequentech/release-tool',
+                        label: 'GitHub',
+                        position: 'right',
+                    },
+                ],
+            },
+            footer: {
+                style: 'dark',
+                links: [
+                    {
+                        title: 'Docs',
+                        items: [
+                            {
+                                label: 'Introduction',
+                                to: '/docs/intro',
+                            },
+                        ],
+                    },
+                ],
+                copyright: `Copyright © ${new Date().getFullYear()} Sequent Tech Inc. Built with Docusaurus.`,
+            },
+            prism: {
+                theme: lightCodeTheme,
+                darkTheme: darkCodeTheme,
+            },
+        }),
+};
+
+module.exports = config;