Welcome to the source code repository of my technical documentation portal and portfolio. This platform is statically built with Astro and Starlight, and serves as a living record of my infrastructure projects.
🌐 Live Documentation: docs.pablorosi.dev
- Framework: Astro
- Documentation Theme: Starlight
- Content: Markdown / MDX
- Deployment: GitHub Actions (CI/CD)
This repository follows the standard structure of an Astro project, integrating the Diátaxis framework within the content folder (src/content/docs/) to organize documentation logically:
├── .github/workflows/ # CI/CD Automation (GitHub Actions)
├── public/ # Raw static resources (favicon.ico)
├── src/
│ ├── assets/ # Processed images and diagrams
│ └── content/
│ └── docs/ # 📝 Documentation core (Markdown/MDX)
│ ├── guides/ # [How-To] Step-by-step guides (e.g., Deploy Nginx)
│ ├── reference/ # [Reference] Raw files (.conf), network schemas
│ ├── theory/ # [Explanation] CCNA theory, architecture decisions
│ └── index.mdx # Home page (Landing Page)
├── astro.config.mjs # Main Astro and Starlight configuration
├── package.json # Dependencies and scripts (npm run dev/build)
└── README.md
If you want to clone this repository and run the documentation in your local environment to make changes, follow these steps:
Make sure you have Node.js installed (version 18 or higher).
Clone the repository and install dependencies:
git clone [https://github.com/pablorosi/docs.git](https://github.com/pablorosi/docs.git)cd docsnpm install