Documentation Index

Welcome to the johnoct.github.io documentation. This guide provides comprehensive information about the Jekyll-based personal website and blog.

Quick Links

• Getting Started - Setup and installation guide
• Architecture Overview - Technical architecture and structure
• Content Management - How to create and manage blog posts
• GitHub Stars Automation - Automated repository tracking
• Deployment Guide - GitHub Pages deployment process
• Style Guide - Writing and formatting guidelines

Overview

This is a personal portfolio and technical blog built with Jekyll and hosted on GitHub Pages. The site features:

• Technical Blog: Cloud engineering and DevOps articles
• GitHub Stars Collection: Automated tracking of interesting repositories
• Clean Design: Minimalist, mobile-responsive layout
• SEO Optimized: Proper meta tags, sitemap, and RSS feed

Site Structure

johnoct.github.io/
├── _posts/              # Blog posts (Markdown)
├── _layouts/            # Jekyll page templates
├── scripts/             # Automation scripts
├── assets/              # Images and other assets
├── docs/                # Documentation (this directory)
├── _config.yml          # Jekyll configuration
├── blog.md              # Blog listing page
├── github-stars.md      # GitHub stars page
├── index.html           # Homepage
└── styles.css           # Main stylesheet

Content Categories

The site organizes content into two main categories:

1. Technical Blog (categories: blog)
   • In-depth technical articles
   • Cloud engineering insights
   • DevOps best practices
   • Personal experiences and learnings
2. GitHub Stars (categories: github-stars)
   • Daily automated collections
   • Weekly curated roundups
   • Open-source project discoveries
   • Repository metadata and descriptions

Getting Help

• Check the Style Guide for writing guidelines
• Review Content Management for post creation
• See GitHub Stars Automation for automation details
• Consult Deployment Guide for publishing changes

Last updated: 2025-08-09