Getting Started
===============

Welcome to the Nexus Embedded Platform! This guide will help you get started with Nexus, from installation to building your first application.

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   introduction
   environment_setup
   quick_start
   project_structure
   build_and_flash
   first_application
   core_concepts
   configuration
   examples_tour
   faq

What You'll Learn
-----------------

This getting started guide covers:

* **Introduction**: What is Nexus and why use it
* **Environment Setup**: Installing tools and dependencies
* **Quick Start**: Build and run your first example in 5 minutes
* **Project Structure**: Understanding the codebase organization
* **Build & Flash**: Compiling and deploying to hardware
* **First Application**: Creating your own application from scratch
* **Core Concepts**: Understanding Nexus architecture
* **Configuration**: Using Kconfig to customize your build
* **Examples Tour**: Exploring the included demo applications
* **FAQ**: Common questions and troubleshooting

Prerequisites
-------------

Before starting, you should have:

* Basic knowledge of C programming
* Familiarity with embedded systems concepts
* A development board (STM32F4 Discovery recommended) or willingness to use native simulation
* Comfortable using command-line tools

Recommended Learning Path
-------------------------

We recommend following the guides in order:

1. Start with :doc:`introduction` to understand what Nexus offers
2. Follow :doc:`environment_setup` to install required tools
3. Try :doc:`quick_start` to build your first example
4. Read :doc:`project_structure` to understand the codebase
5. Learn :doc:`build_and_flash` for deployment workflows
6. Create :doc:`first_application` to build something custom
7. Study :doc:`core_concepts` for deeper understanding
8. Master :doc:`configuration` to customize your build
9. Explore :doc:`examples_tour` for more complex examples
10. Refer to :doc:`faq` when you encounter issues

Quick Links
-----------

* :doc:`quick_start` - Get started in 5 minutes
* :doc:`../tutorials/index` - Step-by-step tutorials
* :doc:`../user_guide/index` - Detailed user guides
* :doc:`../platform_guides/index` - Platform-specific information
* :doc:`../api/index` - API reference documentation

Need Help?
----------

* `GitHub Issues <https://github.com/nexus-platform/nexus/issues>`_ - Report bugs
* `GitHub Discussions <https://github.com/nexus-platform/nexus/discussions>`_ - Ask questions
* :doc:`faq` - Common questions and answers
* :doc:`../development/contributing` - Contributing guide