Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/landerox/landerox.github.io

Personal site focused on data platforms, cloud architecture, automation, and Production AI.
https://github.com/landerox/landerox.github.io

aws bilingual cloud-architecture conventional-commits data-engineering engineering-blog github-pages google-cloud mlops personal-website platform-engineering production-ai python static-site technology-radar zensical

Last synced: 14 days ago
JSON representation

Personal site focused on data platforms, cloud architecture, automation, and Production AI.

Awesome Lists containing this project

README 

          





  landerox.com Banner






  

  Website

  Deploy

  Lint

  Python

  uv

  Zensical

  


  OpenSSF Scorecard

  OpenSSF Best Practices

  OpenSSF Baseline

  Content License: CC BY 4.0

  




Welcome to the source code of my personal and professional digital space.



This repository powers [landerox.com](https://landerox.com) (and its [Spanish

version](https://landerox.com/es/)), a bilingual platform dedicated to **Data

Platforms, Cloud Architecture, and Data & AI Engineering**.



My goal in making this repository public is to provide transparency into my

engineering practices. You are welcome to explore the codebase to review the

CI/CD pipelines, understand the site's architecture, or use my workflows as a

reference for your own projects.



> [!TIP]

> **Looking to build your own personal site with this theme?**

> Instead of using this repository as a starting point (which contains my

> personal copy, bio, and branding), please use the official, unbranded, and

> ready-to-use template:

> 👉 **[Zensical Slate Theme Template](https://github.com/landerox/zensical-slate-theme)**



---



## 🔍 What's Inside



The site's content is structured to provide value on both technical and

strategic levels:



1. **Personal Positioning**: An overview of my professional background,

   technical focus areas, and how I collaborate with engineering teams to

   build scalable architectures.

2. **Engineering Projects**: Detailed breakdowns of reference implementations,

   architectural patterns, and real-world solutions I have developed.

3. **Technology Radar**: A curated, opinionated tracking of tools, ecosystems,

   and frameworks, categorized by their current maturity and adoption level.



## 🛠️ Architecture & Tech Stack



This project is built with a focus on speed, strict dependency management, and

long-term maintainability, leveraging modern tools from the Python ecosystem:



- **Static Generation**: [Zensical](https://zensical.org) — A highly extensible

  and minimalist Python static site generator.

- **Environment Management**: [`uv`](https://github.com/astral-sh/uv) — Used

  for deterministic and exceptionally fast dependency resolution.

- **Task Automation**: [`just`](https://github.com/casey/just) — Serves as the

  central command runner for local development workflows.

- **Infrastructure**: Continuous deployment to **GitHub Pages** orchestrated via

  **GitHub Actions**.



> **Note on Architecture:** I maintain a detailed log of my architectural

> choices. If you are curious about the reasoning behind this stack, please

> refer to [`docs/decisions.md`](docs/decisions.md) and

> [`docs/tooling.md`](docs/tooling.md).



## 🚀 Local Development



If you wish to explore the development environment or run the site locally, the

setup is designed to be frictionless.



### 📦 Option A: Dev Container (Recommended)



This is the cleanest approach, ensuring your local environment remains isolated:



1. Open this repository in **VS Code** with the **Dev Containers** extension

   installed (or use GitHub Codespaces).

2. The environment will automatically provision Python 3.13, `uv`, `just`, and

   all necessary linting/validation tools.



### 💻 Option B: Bare-Metal Installation



If you prefer running it directly on your machine, ensure you have **Python

3.13+**, [`uv`](https://github.com/astral-sh/uv), and

[`just`](https://github.com/casey/just) installed:



```bash

# 1. Clone the repository

git clone https://github.com/landerox/landerox.github.io.git

cd landerox.github.io



# 2. Install dependencies via uv

just sync



# 3. Start the development server

just serve               # English server (http://127.0.0.1:8000)

just serve-es            # Spanish server (http://127.0.0.1:8001)

```



*Tip: Running `just` in your terminal with no arguments will display a full list

of available automated tasks (e.g., building, linting, link validation).*



## 📂 Repository Structure



Key directories and files to help you navigate the codebase:



- `content/en/` & `content/es/` — The markdown source files containing the

  bilingual content.

- `zensical*.toml` — The core configuration files for the static site generator.

- `.github/workflows/` — CI/CD pipelines governing deployments, security scans

  (OpenSSF), and code quality.

- `docs/` — Internal documentation, including style guidelines, repository

  structure, and maintenance runbooks.

- `CHANGELOG.md` — Manually curated release notes following the Keep a Changelog

  standard.



## 🤝 Contributing



While this is a personal site, technical corrections, bug reports, or

suggestions are highly appreciated. Please refer to the [Contributing

Guidelines](.github/CONTRIBUTING.md) before opening an Issue or submitting a

Pull Request.



## 📄 License



To maintain a clear boundary between the open-source engine and my personal

intellectual property, this repository operates under a dual-license model:



- **Source Code** (`pyproject.toml`, `.github/`, scripts, tooling

  configurations) is released under the [MIT License](LICENSE).

- **Site Content** (Markdown files under `content/`, images, and authored prose)

  is released under the [Creative Commons Attribution 4.0 International License

  (CC-BY-4.0)](LICENSE-CONTENT).