link update

Author: balotofi

_site/index.html

@@ -22,4 +22,40 @@ Follow these guides to assemble the necessary hardware components:
 
 If you encounter issues or need further clarification, feel free to reach out to the development team.  
 
+---
+title: Hardware Guide
+nav_order: 2
+has_children: true
+description: "Technical reference for the BIRDS CubeSat hardware subsystems."
+---
+
+# 🔩 BIRDS Hardware Guide
+
+This section provides detailed documentation on the physical components that make up the BIRDS CubeSat bus.
+
+From power systems to communication boards, sensors to solar panels, you'll find background explanations, electrical schematics, usage notes, and assembly tips to support both education and implementation.
+
+---
+
+## 🧱 Subsystem Categories
+
+- Electrical Power System (EPS)
+- On-Board Computer (OBC)
+- Communication Module (UHF/VHF/S-band)
+- ADCS (Attitude Determination & Control System)
+- Structural Design & Integration
+
+---
+
+## 📎 Using this Guide
+
+Each section contains:
+- Block diagrams and system overviews
+- Board photos and layout info
+- BOMs (Bill of Materials)
+- Key pinouts and signal references
+- Recommendations for testing and integration
+
+> 💡 Tip: When modifying hardware, always cross-check connector types and thermal constraints.
+
 [Next]({{site.url}}/how-tos/flash_microcontroller.html)  {: .btn}

hardware/index.md

@@ -12,6 +12,43 @@ lang: en
 
 Welcome to the step-by-step guides for assembling hardware and setting up software for the system. These tutorials will help you with assembling the necessary boards, preparing cables, writing software, compiling code, and flashing it onto the microcontroller.  
 
+---
+title: Software Guide
+nav_order: 3
+has_children: true
+description: "Understand the BIRDS bus software stack, architecture, and how to use it."
+---
+
+# 💻 BIRDS Software Guide
+
+This guide walks you through the software that powers BIRDS CubeSats — from low-level microcontroller code to high-level mission logic.
+
+You'll find architecture diagrams, programming conventions, examples, and testing tools that help you work with or build upon the flight software.
+
+---
+
+## 🧠 What's Inside
+
+- Bootloader and initialization routines
+- Communication protocols (e.g., AX.25)
+- Housekeeping and telemetry handling
+- Payload command/control logic
+- Sample ground station scripts
+
+---
+
+## 🧰 Development Workflow
+
+The BIRDS software follows modular principles to support mission-specific customization while keeping a clean baseline. Key topics include:
+
+- How to set up your development environment
+- Coding standards and directory structure
+- Simulating subsystems
+- Flashing firmware and debugging
+
+> 📦 Example: See our [Hello World example](../software/examples/hello-world.md) for a minimal startup app.
+
+
 ## Software Development Guides
 
 Learn how to configure, compile, and flash software onto the system: