task: update documentation

book.toml

@@ -1,5 +1,5 @@
 [book]
-authors = ["weird-bytecode"]
+authors = ["DecisiveAI, Inc."]
 language = "en"
 multilingual = false
 src = "src"

src/JILL_ALL_DOCS.md

@@ -0,0 +1,18 @@
+---
+title: Documentation
+linkTitle: Docs
+menu: { main: { weight: 10 } }
+---
+
+MyDecisive.ai, also known as MDAI, is an Open-source framework
+for instrumenting, generating, collecting, and exporting telemetry data such as
+[traces](/docs/concepts/signals/traces/),
+[metrics](/docs/concepts/signals/metrics/), and
+[logs](/docs/concepts/signals/logs/).
+
+As an industry-standard, OpenTelemetry is
+[supported by more than 40 observability vendors](/ecosystem/vendors/),
+integrated by many [libraries, services, and apps](/ecosystem/integrations), and
+adopted by [numerous end users](/ecosystem/adopters).
+
+![OpenTelemetry Reference Architecture](/img/otel-diagram.svg)

src/SUMMARY.md

@@ -1,11 +1,74 @@
-# Summary
+# MyDecisive (MDAI) Engine©
 
-[Introduction](./intro.md)
+- [Introduction]()
+  - [Overview](./intro/overview.md)
+  - [The MDAI Engine©](./intro/intro.md)
+  - [Expectations](./intro/expectations.md)
 
+- [Installation]()
+  - [Installing the MDAI Engine©](./install/installation.md)
+  - [Quick Start](./install/quick-start.md)
+  - [MDAI Engine© in AWS](./install/aws.md)
+
+<!--
 # Usage Guide
 
 - [Installation](./install/install.md)
   - [To an existing k8s cluster](./install/k8s-helm.md)
   - [To a new AWS EKS cluster](./install/k8s-cdk.md)
 - [Configuration](./Operation/config.md)
 - [Troubleshooting](./troubleshooting.md)
+
+
+
+#### Collector requirements
+
+#### Sizing and Scaling
+
+
+#### Processor Architecture
+
+
+
+### Configure
+### Install
+
+- Installation instructions for deploying EKS locally or on-premises
+- Setup instructions for OpenTelemetry and Prometheus components
+- Basic configuration steps
+
+-----------------------------------------------------------------------
+
+## Contributing
+- Guidelines for contributing code, documentation, or bug fixes
+- Code repository location (e.g., GitHub)
+- Contribution guidelines and code review process
+
+## Community Engagement
+- Links to community forums, mailing lists, or chat channels
+- How to get support (e.g., FAQs, support tickets)
+- Opportunities for community involvement
+
+## Risk and Disclaimers
+- Potential risks associated with using pre-alpha software
+- Disclaimer about stability, data loss, and other issues
+- Recommended backup and recovery procedures
+
+## Legal and Licensing
+- License information for the pre-alpha release
+- Copyright notices and third-party dependencies
+- Terms of use for early adopters
+
+## Future Development
+- Planned features and improvements for upcoming releases
+- Roadmap for transitioning from pre-alpha to alpha/beta stages
+- Community feedback integration process
+
+## Glossary
+- Definitions of technical terms and acronyms used in the documentation
+
+## Appendices
+- Additional resources for testers and contributors
+- Release notes for the pre-alpha version
+- Frequently Asked Questions (FAQs) specific to the pre-alpha release
+-->

src/architecture-overview.md

@@ -0,0 +1,4 @@
+## Architecture Overview
+- Overview of the system architecture with EKS, OpenTelemetry, and Prometheus
+- High-level components and their interactions
+- Data flow diagrams illustrating telemetry collection and monitoring processes

src/deployment.md

@@ -0,0 +1,4 @@
+## Deployment Guide
+- Step-by-step instructions for deploying EKS clusters locally or on-premises
+- Configuration steps for deploying OpenTelemetry components (collectors, exporters) on EKS
+- Configuration steps for deploying Prometheus for self-monitoring

src/feedback.md

@@ -0,0 +1,10 @@
+## How to give the MyDecisive Team feedback
+
+### General Feedback
+TODO
+
+### Bug Reports
+TODO
+
+### Feature Requests
+TODO