Sorting Series (1): How to Choose an Algorithm - Time, Space, Stability, Scenarios

Use the ACERS template to map common sorting algorithms by scenario, complexity, stability, and engineering usage, with runnable examples and a selection checklist.

December 1, 2025 · 6 min · map[name:Jeanphilo]

UFW + CrowdSec: Stop Malicious Port Scans (From Fail2ban Pain to a Modern Solution)

UFW + CrowdSec: Stop Malicious Port Scans Subtitle / Abstract: How do you protect exposed server ports? This guide shows how to move past Fail2ban regex hell and build a stable, automated, intelligent port-scan defense system. Target readers Developers using FRP or reverse tunnels Operators of cloud servers (Tencent, Alibaba, AWS, etc.) Linux users who want to stop port scans and SSH brute force People using Fail2ban who want a modern alternative Anyone improving personal server security Background / Motivation: Why you need port-scan defense When you run FRP (frps + frpc) or expose multiple ports, you will often see: ...

November 22, 2025 · 3 min · map[name:Jeanphilo]

WireGuard Full Guide: Build a Secure High-Speed Private Network (VPN Tutorial)

WireGuard Full Guide: Build a Secure High-Speed Private Network (VPN Tutorial) Subtitle / Abstract: A beginner-to-intermediate WireGuard VPN guide. Learn to build a fast, secure private network and enforce a zero-exposure model where services are only reachable through VPN. Target readers People who want to hide server or PC ports behind a VPN Users who want to reduce scanning and brute force risk Anyone building a private LAN or remote access to home Linux/Windows users, developers, and ops beginners Background and motivation: Why WireGuard? If you expose ports to the public internet (SSH, databases, admin panels), you will face: ...

November 20, 2025 · 4 min · map[name:Jeanphilo]

How to Build a Blog System

Build a Hugo Blog with GitHub Pages in 10 Minutes Subtitle / Abstract This guide takes you from zero to a deployed Hugo blog on GitHub Pages with GitHub Actions. It is beginner-friendly and explains the key moving parts. Target readers Hugo beginners Developers who want a quick technical blog Users of GitHub Pages and GitHub Actions Anyone who wants free static hosting Background / Motivation Common pain points when publishing a blog: ...

November 14, 2025 · 2 min · map[name:Jeanphilo]

How to Publish with Hugo

How to Publish with Hugo: From Markdown to Online Blog Subtitle / Abstract This guide explains how to create, manage, and publish Hugo posts: front matter, drafts, images, directory structure, local preview, and deployment. Target readers Hugo beginners Developers building a technical blog with Hugo Writers using Markdown + static sites Users of PaperMod, DoIt, and similar themes Background / Motivation After setting up a Hugo site, common questions include: ...

November 14, 2025 · 2 min · map[name:Jeanphilo]

Write Clear Issues with Templates: From Zero to GitHub Issue Forms

Title (accurate and keyword-rich) Write Clear Requirements with Issue Templates: A Complete Guide to GitHub Issue Forms Subtitle / Abstract This post teaches you how to configure GitHub Issue templates for feature requests and bug reports, including folder structure, YAML forms, Markdown templates, and common pitfalls. It is ideal for teams that want clearer requirements and less back-and-forth. Target readers This article is for: Backend/frontend/full-stack engineers who create Issues regularly Leads/TLs/architects who want standardized requirement intake Mid-level developers familiar with GitHub but new to Issue templates Beginners can follow, but basic GitHub knowledge is assumed. ...

November 11, 2025 · 7 min · map[name:Jeanphilo]

API Standards

Title How to Write a Qualified API Document: From Swagger to Modern OpenAPI Subtitle / Abstract Want developers to actually enjoy using your API? This article covers the structure, examples, and best practices of high-quality API documentation based on Swagger/OpenAPI (originally by Tony Tam). Target readers Beginners who want a standard API doc structure Mid-level developers improving maintainability Architects and leads defining API standards Background / Motivation Common problems in API docs: ...

November 6, 2025 · 3 min · map[name:Jeanphilo]

Thoughts on AI Systems

For a system, a single thread should be a single assistant. We should provide each user with one assistant and optimize that assistant. Providing many parallel threads per user is too expensive and unnecessary.

October 31, 2025 · 1 min · map[name:Jeanphilo]

How to Set Up Gitea

Run Gitea Locally: Your Private GitHub (with Existing Repo Import) Subtitle / Abstract: This guide walks you through installing the lightweight Git server Gitea on your local machine. No root required, no system pollution. Manage, browse, and push projects like GitHub, and import existing repos. Target readers: Personal developers, indie engineers, and small team leads with basic Git knowledge. Background / Motivation Many developers want: to host code inside a company or LAN to avoid cloud platforms (GitHub/Gitee) to have a web UI, pull requests, and code browsing GitLab is heavy (often multiple GB of RAM). Gitea is: ...

October 28, 2025 · 4 min · map[name:Jeanphilo]

Conventional Commits: Make Team Collaboration and Automation Efficient

Title From feat to fix: master Git commit conventions for collaboration and automation Subtitle / Abstract A practical guide to Conventional Commits. Learn commit types (feat:, fix:), write clean messages, and enable automatic changelogs and releases. Target readers Beginners: new to Git, want better commit habits. Mid-level devs: want commits friendly to team and CI. Leads/architects: want a consistent team standard. Background / Motivation Most commit messages look like: “update code” “fix bug” “some changes” ...

October 25, 2025 · 3 min · map[name:Jeanphilo]