Update site index and OSS landing page

- Fix broken link to OSS section (case mismatch)
- Fix typo in index.md
- Add MCP Server to main navigation
- Update OSS index with links to all products
- Add getting started workflow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: respencer-ncl

docs/OSS/index.md

@@ -1,19 +1,87 @@
 # Ossum Open Source Software
 
-In this section you will find open source software released by Ossum Inc. Feel free to try it out! There is no charge 
-for using this Ossum software! 
+Ossum Inc. provides open source tools for working with the RIDDL language.
+All software is free to use under the Apache License 2.0.
 
-Here are the open source projects:
+## IDE Extensions
 
-* [RIDDL](./riddl/index.md)
-* [VS Code Extension For RIDDL](./vscode-extension/index.md)
-* [IntelliJ IDEA Plugin](./intellij-plugin/index.md)
+### [IntelliJ IDEA Plugin](./intellij-plugin/index.md)
+
+RIDDL language support for JetBrains IntelliJ IDEA, including:
+
+- Syntax highlighting with customizable colors
+- Real-time validation and error detection
+- Integrated RIDDL tool window
+- Clickable error navigation
+
+**Status**: Beta - [Download](https://github.com/ossuminc/riddl-idea-plugin/releases)
+
+### [VS Code Extension](./vscode-extension/index.md)
+
+RIDDL language support for Visual Studio Code, including:
+
+- Syntax highlighting with semantic tokens
+- IntelliSense code completion (50+ keywords)
+- Real-time diagnostics
+- Go to Definition and Find References
+- Hover documentation
+
+**Status**: Beta - [Download](https://github.com/ossuminc/riddl-vscode/releases)
+
+---
+
+## Writing RIDDL
+
+### [Authoring RIDDL Sources](./authoring-riddl.md)
+
+A comprehensive guide to writing effective RIDDL source files, covering:
+
+- File organization and includes
+- Adding metadata with the `with` clause
+- Type definitions and references
+- Commands, events, queries, and results
+- Entity design patterns
+- Handler statements
+- Common patterns and best practices
+
+This guide applies to any IDE or editor.
 
 ---
 
-If you have any questions or need assistance, please contact our support team at support@ossuminc.com
+## AI-Assisted Modeling
+
+### [RIDDL MCP Server](../MCP/index.md)
+
+Connect AI assistants to the RIDDL MCP Server for intelligent modeling
+assistance:
+
+- Validate RIDDL code with detailed error messages
+- Check model completeness and get suggestions
+- Convert natural language to RIDDL structures
+- Get explanations for validation errors
+
+Supports: Claude Desktop, Claude Code, Gemini CLI, VS Code Copilot,
+IntelliJ AI Assistant, and IntelliJ Junie.
+
+---
+
+## Getting Started
+
+1. **Install an IDE extension** for your preferred editor
+2. **Read the authoring guide** to learn RIDDL best practices
+3. **Connect the MCP server** for AI-assisted modeling (optional)
+
+---
+
+## Support
+
+If you have questions or need assistance:
 
-If you are interested in contributing to our open source projects, please visit our GitHub organization at
-https://github.com/ossuminc. 
+- **Email**: support@ossuminc.com
+- **GitHub**: [github.com/ossuminc](https://github.com/ossuminc)
 
+## Contributing
 
+We welcome contributions to all open source projects. Visit the GitHub
+repositories linked above to report issues, suggest features, or submit
+pull requests.

docs/index.md

@@ -5,14 +5,12 @@ title: "Ossum!"
 
 This site provides documentation for technologies created at Ossum, Inc.
 
-THe sections at the top correspond to our products:
-
-* [OSS](oss/index.md)
-* [RIDDL](riddl/index.md)
-* [Synapify](synapify/index.md)
-* [Docify](docify/index.md)
-* [Verify](verify/index.md)
+The sections at the top correspond to our products:
 
+* [RIDDL](riddl/index.md) - General documentation about the core language behind all products
+* [MCP Server](MCP/index.md) - Documentation for the MCP Server, a REST API for managing RIDDL models
+* [OSS](OSS/index.md) - A collection of open source tools to aid in RIDDL modeling
+* [Synapify](synapify/index.md) - The user interface for RIDDL models
 
 # Information
 * Author: Ossum Inc.