Docs: Add v2 rewrite while preserving v1.0 to support ODE major release 1.0 (#7)

Author: najuna-brian

.github/workflows/deploy.yml

@@ -20,7 +20,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
           cache: npm
 
       - name: Install dependencies
@@ -45,7 +45,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
           cache: npm
 
       - name: Install dependencies

.gitignore

@@ -1,20 +1,41 @@
 # Dependencies
-/node_modules
+node_modules/
 
-# Production
-/build
+# Production build
+build/
+.docusaurus/
+.cache-loader/
 
 # Generated files
-.docusaurus
-.cache-loader
+.docusaurus/
+.cache/
 
 # Misc
 .DS_Store
+.env
 .env.local
 .env.development.local
 .env.test.local
 .env.production.local
 
+# Logs
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+lerna-debug.log*
+
+# Editor directories and files
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.project
+.classpath
+.settings/
+*.sublime-workspace
+
+# OS
+.DS_Store
+Thumbs.db
+

README.md

@@ -62,4 +62,4 @@ The website is deployed automatically using GitHub Actions when changes are push
 2. Runs full Docusaurus build
 3. Deploys to GitHub Pages (only if all checks pass)
 
-Broken links or validation errors will prevent deployment.
+Broken links or validation errors will prevent deployment.

babel.config.js

@@ -0,0 +1,4 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};
+

create-placeholders.sh

@@ -0,0 +1,89 @@
+#!/bin/bash
+# Create placeholder markdown files for all documentation pages
+
+# Guides - Forms
+echo "---\nsidebar_position: 2\n---\n\n# Schema Definition\n\n[Placeholder: Content will be added]" > docs/guides/forms/schema-definition.md
+echo "---\nsidebar_position: 3\n---\n\n# UI Schema\n\n[Placeholder: Content will be added]" > docs/guides/forms/ui-schema.md
+echo "---\nsidebar_position: 4\n---\n\n# Validation\n\n[Placeholder: Content will be added]" > docs/guides/forms/validation.md
+echo "---\nsidebar_position: 5\n---\n\n# Conditional Logic\n\n[Placeholder: Content will be added]" > docs/guides/forms/advanced-features.md
+
+# Guides - Custom Apps
+echo "---\nsidebar_position: 1\n---\n\n# Custom Applications Overview\n\n[Placeholder: Content will be added]" > docs/guides/custom-apps/overview.md
+echo "---\nsidebar_position: 2\n---\n\n# Building Custom Applications\n\n[Placeholder: Content will be added]" > docs/guides/custom-apps/building.md
+echo "---\nsidebar_position: 3\n---\n\n# App Bundle Structure\n\n[Placeholder: Content will be added]" > docs/guides/custom-apps/app-bundle-structure.md
+echo "---\nsidebar_position: 4\n---\n\n# Deployment\n\n[Placeholder: Content will be added]" > docs/guides/custom-apps/deployment.md
+echo "---\nsidebar_position: 5\n---\n\n# Custom Renderers\n\n[Placeholder: Content will be added]" > docs/guides/custom-apps/custom-renderers.md
+
+# Guides - Deployment
+echo "---\nsidebar_position: 1\n---\n\n# Deployment Overview\n\n[Placeholder: Content will be added]" > docs/guides/deployment/overview.md
+echo "---\nsidebar_position: 2\n---\n\n# Docker Deployment\n\n[Placeholder: Content will be added]" > docs/guides/deployment/docker.md
+echo "---\nsidebar_position: 3\n---\n\n# Production Deployment\n\n[Placeholder: Content will be added]" > docs/guides/deployment/production.md
+echo "---\nsidebar_position: 4\n---\n\n# Monitoring\n\n[Placeholder: Content will be added]" > docs/guides/deployment/monitoring.md
+
+# Guides - Other
+echo "---\nsidebar_position: 5\n---\n\n# User Management\n\n[Placeholder: Content will be added]" > docs/guides/user-management.md
+echo "---\nsidebar_position: 6\n---\n\n# Branding\n\n[Placeholder: Content will be added]" > docs/guides/branding.md
+echo "---\nsidebar_position: 7\n---\n\n# Translations\n\n[Placeholder: Content will be added]" > docs/guides/translations.md
+
+# Reference - API
+echo "---\nsidebar_position: 1\n---\n\n# API Overview\n\n[Placeholder: Content will be added]" > docs/reference/api/overview.md
+echo "---\nsidebar_position: 2\n---\n\n# Authentication\n\n[Placeholder: Content will be added]" > docs/reference/api/authentication.md
+echo "---\nsidebar_position: 3\n---\n\n# API Endpoints\n\n[Placeholder: Content will be added]" > docs/reference/api/endpoints.md
+
+# Reference - Configuration
+echo "---\nsidebar_position: 1\n---\n\n# Server Configuration\n\n[Placeholder: Content will be added]" > docs/reference/configuration/server.md
+echo "---\nsidebar_position: 2\n---\n\n# Client Configuration\n\n[Placeholder: Content will be added]" > docs/reference/configuration/client.md
+
+# Reference - Other
+echo "---\nsidebar_position: 2\n---\n\n# Form Specifications\n\n[Placeholder: Content will be added]" > docs/reference/form-specifications.md
+echo "---\nsidebar_position: 3\n---\n\n# App Bundle Format\n\n[Placeholder: Content will be added]" > docs/reference/app-bundle-format.md
+
+# Reference - Components
+echo "---\nsidebar_position: 1\n---\n\n# Formulus\n\n[Placeholder: Content will be added]" > docs/reference/components/formulus.md
+echo "---\nsidebar_position: 2\n---\n\n# Synkronus\n\n[Placeholder: Content will be added]" > docs/reference/components/synkronus.md
+echo "---\nsidebar_position: 3\n---\n\n# Synkronus CLI\n\n[Placeholder: Content will be added]" > docs/reference/components/synkronus-cli.md
+echo "---\nsidebar_position: 4\n---\n\n# Formplayer\n\n[Placeholder: Content will be added]" > docs/reference/components/formplayer.md
+
+# Development - Getting Started
+echo "---\nsidebar_position: 1\n---\n\n# Development Setup\n\n[Placeholder: Content will be added]" > docs/development/getting-started/setup.md
+echo "---\nsidebar_position: 2\n---\n\n# Architecture Overview\n\n[Placeholder: Content will be added]" > docs/development/getting-started/architecture.md
+echo "---\nsidebar_position: 3\n---\n\n# Codebase Overview\n\n[Placeholder: Content will be added]" > docs/development/getting-started/codebase-overview.md
+
+# Development - Architecture
+echo "---\nsidebar_position: 1\n---\n\n# Architecture Overview\n\n[Placeholder: Content will be added]" > docs/development/architecture/overview.md
+echo "---\nsidebar_position: 2\n---\n\n# Components\n\n[Placeholder: Content will be added]" > docs/development/architecture/components.md
+echo "---\nsidebar_position: 3\n---\n\n# Data Flow\n\n[Placeholder: Content will be added]" > docs/development/architecture/data-flow.md
+echo "---\nsidebar_position: 4\n---\n\n# Sync Protocol\n\n[Placeholder: Content will be added]" > docs/development/architecture/sync-protocol.md
+echo "---\nsidebar_position: 5\n---\n\n# Database\n\n[Placeholder: Content will be added]" > docs/development/architecture/database.md
+
+# Development - Contributing
+echo "---\nsidebar_position: 1\n---\n\n# Contributing Guide\n\n[Placeholder: Content will be added]" > docs/development/contributing/guide.md
+echo "---\nsidebar_position: 2\n---\n\n# Code of Conduct\n\n[Placeholder: Content will be added]" > docs/development/contributing/code-of-conduct.md
+echo "---\nsidebar_position: 3\n---\n\n# First Contribution\n\n[Placeholder: Content will be added]" > docs/development/contributing/first-contribution.md
+echo "---\nsidebar_position: 4\n---\n\n# Coding Standards\n\n[Placeholder: Content will be added]" > docs/development/contributing/coding-standards.md
+
+# Development - Building
+echo "---\nsidebar_position: 1\n---\n\n# Building from Source\n\n[Placeholder: Content will be added]" > docs/development/building/from-source.md
+echo "---\nsidebar_position: 2\n---\n\n# Building Components\n\n[Placeholder: Content will be added]" > docs/development/building/components.md
+echo "---\nsidebar_position: 3\n---\n\n# Testing\n\n[Placeholder: Content will be added]" > docs/development/building/testing.md
+echo "---\nsidebar_position: 4\n---\n\n# CI/CD Pipeline\n\n[Placeholder: Content will be added]" > docs/development/building/ci-cd.md
+
+# Development - Extending
+echo "---\nsidebar_position: 1\n---\n\n# Extending ODE Overview\n\n[Placeholder: Content will be added]" > docs/development/extending/overview.md
+echo "---\nsidebar_position: 2\n---\n\n# Custom Renderers\n\n[Placeholder: Content will be added]" > docs/development/extending/custom-renderers.md
+echo "---\nsidebar_position: 3\n---\n\n# Plugins\n\n[Placeholder: Content will be added]" > docs/development/extending/plugins.md
+echo "---\nsidebar_position: 4\n---\n\n# Internal APIs\n\n[Placeholder: Content will be added]" > docs/development/extending/internal-apis.md
+
+# Development - Technical
+echo "---\nsidebar_position: 1\n---\n\n# Database Schema\n\n[Placeholder: Content will be added]" > docs/development/technical/database-schema.md
+echo "---\nsidebar_position: 2\n---\n\n# Sync Protocol\n\n[Placeholder: Content will be added]" > docs/development/technical/sync-protocol.md
+echo "---\nsidebar_position: 3\n---\n\n# Security\n\n[Placeholder: Content will be added]" > docs/development/technical/security.md
+echo "---\nsidebar_position: 4\n---\n\n# Performance\n\n[Placeholder: Content will be added]" > docs/development/technical/performance.md
+
+# Community
+echo "---\nsidebar_position: 2\n---\n\n# Getting Help\n\n[Placeholder: Content will be added]" > docs/community/getting-help.md
+echo "---\nsidebar_position: 3\n---\n\n# Reporting Issues\n\n[Placeholder: Content will be added]" > docs/community/reporting-issues.md
+echo "---\nsidebar_position: 4\n---\n\n# Examples\n\n[Placeholder: Content will be added]" > docs/community/examples.md
+echo "---\nsidebar_position: 5\n---\n\n# Projects\n\n[Placeholder: Content will be added]" > docs/community/projects.md
+
+echo "Placeholder files created successfully"