Reorganize Future Work into Coming Soon section

- Create consolidated Coming Soon page with Simulation and Generation sections
- Move future-work content to top-level nav (before About)
- Include generation targets from riddl-gen roadmap
- Fix broken fontawesome icons with material-recycle icon
- Remove old docs/riddl/future-work/ directory

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

Author: respencer-ncl

NOTEBOOK.md

@@ -5,6 +5,25 @@
 Documentation site is complete and deployed at https://ossum.tech. All major
 sections are documented with proper RIDDL syntax highlighting.
 
+**Completed (2026-01-29):**
+
+- Reorganized "Future Work" into top-level "Coming Soon" section
+  - Created consolidated `docs/coming-soon/index.md` with Simulation and
+    Generation sections
+  - Removed old `docs/riddl/future-work/` directory (8 files)
+  - Generation section includes targets from riddl-gen NOTEBOOK.md
+- Fixed broken fontawesome icons (`:fontawesome-regular-rotate-left:`) with
+  Material Design icons (`:material-recycle:`) in concept pages
+- Migrated RIDDL documentation from riddl.tech (Hugo) to ossum.tech (MkDocs)
+- Created migration script: `scripts/migrate-hugo.py`
+- Added Tutorials section with complete RBBQ case study (18 files)
+- Expanded Tools/riddlc with installation, commands, configuration, etc.
+- Added sbt-riddl plugin documentation
+- Added Design Guide (contexts, command-event patterns, UI modeling)
+- Added Developer Guide (principles, releasing)
+- Updated mkdocs.yml navigation for all new sections
+- Verified build with `mkdocs build --strict`
+
 **Completed (2026-01-28):**
 
 - Navigation reordered: RIDDL → Synapify → MCP → IDE Support → About
@@ -60,7 +79,6 @@ sections are documented with proper RIDDL syntax highlighting.
 | Task | File | Notes |
 |------|------|-------|
 | Type examples | `references/language-reference.md` | Add specialized examples |
-| Future work review | `future-work/` | Update for current roadmap |
 | Synapify generation docs | `synapify/generation.md` | Use preserved config |
 
 ---

docs/coming-soon/index.md

@@ -0,0 +1,86 @@
+---
+title: "Coming Soon"
+description: "Upcoming features for the RIDDL ecosystem"
+---
+
+# Coming Soon
+
+This page outlines upcoming capabilities for the RIDDL ecosystem. These
+features are under active development and will be available through
+[Synapify](../synapify/index.md) and related tooling.
+
+---
+
+## Simulation
+
+The [riddlsim](https://github.com/ossuminc/riddlsim) engine executes RIDDL
+models against test scenarios, validating behavior before implementation.
+
+**Why simulate?**
+
+- **Catch design errors early** before they become expensive implementation
+  bugs
+- **Verify state transitions** to ensure entities move through expected
+  lifecycles
+- **Test edge cases** that might be overlooked in manual review
+- **Build stakeholder confidence** by demonstrating working behavior early
+- **Document expected behavior** through executable scenarios
+
+Simulation scenarios define inputs, expected events, and state assertions.
+When a scenario runs, the simulator parses your model, executes the 
+scenario steps, and reports whether outcomes match expectations.
+
+For detailed information on simulation capabilities and integration with
+Synapify, see the [Synapify Simulation Guide](../synapify/simulation.md).
+
+---
+
+## Generation
+
+The RIDDL ecosystem will support code and artifact generation from validated
+models. Generation transforms your domain model into runnable infrastructure,
+documentation, and integration artifacts.
+
+### Documentation Generators
+
+| Target | Description |
+|--------|-------------|
+| **Hugo** | Static documentation site with navigation, diagrams, and cross-references. Currently available. |
+| **AsciiDoc** | Technical documentation in AsciiDoc format for integration with enterprise documentation systems. |
+| **Diagrams** | Mermaid-based visualizations including context maps, data flow, sequence diagrams, and entity relationships. |
+
+### API & Schema Generators
+
+| Target      | Description                                                                                                 |
+|-------------|-------------------------------------------------------------------------------------------------------------|
+| **OpenAPI** | OpenAPI (Swagger) specifications documenting REST APIs implied by Applications and their endpoints.         |
+| **gRPC**    | Google's efficient serialization format protobuf enables gRPC services and cross-language interoperability. |
+| **Smithy**  | AWS Interface Definition Language for defining services that integrate with AWS infrastructure.             |
+
+### Runtime Code Generators
+
+| Target      | Description                                                                                                                                                                                                  |
+|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Akka**    | Complete Scala/Akka project including actors, protobuffers, sbt build files, and runtime dependencies. Generates infrastructure code while leaving business logic to developers or have AI do the whole job. |
+| **Quarkus** | Complete Java/Quarkus project using many Quarkus ecosystem features for reactive distributed systems.                                                                                                        |
+
+### Integration Generators
+
+| Target | Description                                                                                                                                                 |
+|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Backstage** | Catalog entries for [Spotify Backstage](https://backstage.io/) developer portals, documenting service ownership and relationships.                          |
+| **BAST** | Binary Abstract Syntax Tree format for faster parsing. Saves validated models in a binary format that loads quickly, avoiding re-parsing and re-validation. |
+
+### Extending Generation
+
+The generation architecture is designed for extensibility. Custom generators can
+be implemented to target additional platforms, frameworks, or output formats.
+If you need a specific kind of generation, email us at mailto:support@ossuminc.com
+
+---
+
+!!! NOTE: Timeline
+
+These features are being developed iteratively. Generators will be released
+as they reach production quality.  For the latest status, see the 
+[Synapify documentation](../synapify/index.md). 

docs/riddl/concepts/domain.md

@@ -35,7 +35,7 @@ might devise a domain hierarchy like this:
 ## Occurs In
 
 * [Root](root.md)
-* [Domains](domain.md) :fontawesome-regular-rotate-left: — domains
+* [Domains](domain.md) :material-recycle: — domains
   can be nested in a super-domain
 
 ## Contains
@@ -46,7 +46,7 @@ Within a domain, you can define these things:
 * [Applications](application.md) - a user interface  
 * [Authors](author.md) - who defined the domain
 * [Contexts](context.md) - a precisely defined bounded context within the domain
-* [Domains](domain.md) :fontawesome-regular-rotate-left: - domains 
+* [Domains](domain.md) :material-recycle: - domains
   can have nested domains (subdomains)
 * [Epics](epic.md) - a story about external entities
   interacting with the domain

docs/riddl/concepts/element.md

@@ -46,6 +46,6 @@ different group of elements, enabling navigation within the application.
 * [Group](group.md)
 
 ## Contains
-* [Group](group.md) :fontawesome-regular-rotate-left:
+* [Group](group.md) :material-recycle:
 * [Handlers](handler.md)
 

docs/riddl/concepts/function.md

@@ -16,4 +16,4 @@ for something once.
 ## Contains
 * [Fields](field.md)
 * [Statements](statement.md)
-* [Functions](function.md) :fontawesome-regular-rotate-left:
+* [Functions](function.md) :material-recycle:

docs/riddl/concepts/group.md

@@ -23,7 +23,7 @@ their overall UI design theme.
 * [Group](group.md)
 
 ## Contains
-* [Group](group.md) :fontawesome-regular-rotate-left:
+* [Group](group.md) :material-recycle:
 * [Type](type.md)
 * [Input](input.md)
 * [Output](output.md)