*********************************
Welcome to OSConfig Documentation
*********************************

This documentation provides a comprehensive guide for configuring and 
maintaining a consistent development environment across multiple operating 
systems, including Arch Linux, Pop!_OS, and macOS. It is designed to support 
users through every stage of the system lifecycle—from initial setup to 
long-term customization and troubleshooting.

The guide begins with pre-installation procedures, such as preparing 
installation media and configuring system prerequisites, followed by detailed 
operating system installation steps. It then transitions into post-installation 
configuration, including the setup of essential development tools, libraries, 
and utilities such as Git, Neovim, SSH, and modern shell environments.

In addition, this documentation outlines standardized approaches for managing 
configuration files (e.g., tmux, Neovim, Bash, and Zsh), including where to 
place them within the system and how to integrate them with this repository. 
Troubleshooting sections are provided to help diagnose and resolve common 
issues, ensuring a stable and reproducible development environment.

The goal of this documentation is to provide a clear, efficient, and 
repeatable process for building a robust development setup, whether starting 
from a fresh installation or refining an existing system.

Table of Contents
==================

.. toctree::
   :maxdepth: 1
   :caption: Modules:

    Arch Linux <Arch>
    PopOS Linux <Pop>
    Macintosh <Mac>
    System Configuration <System>

Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`