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: ...

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.

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: ...

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” ...

Bengio-style ML Task Specification: From Research to Engineering Subtitle: How to write a reproducible, explainable, and comparable fine-tuning task document based on Yoshua Bengio’s methodology. Reading time: 10 minutes Tags: ML documentation, fine-tuning, technical standards, deep learning practice Audience: mid to senior ML engineers, researchers, technical writers 1. Why do we need this document? In ML projects, teams often run fine-tuning experiments. Months later, nobody can reproduce results or explain why a learning rate or LoRA layer was chosen. ...

Ping Works but SSH Fails: A Real Case of SSH vs VNC Subtitle: From connection refusal to protocol identification: understand TCP, SSH, and VNC Reading time: 7 minutes Tags: network troubleshooting, SSH, VNC, Linux, remote access SEO keywords: SSH connection failed, kex_exchange_identification, VNC port 5905, RFB 003.008, SSH vs VNC Target readers Linux users, developers, and server admins Engineers learning systematic network troubleshooting Readers interested in SSH/VNC protocol behavior Background and motivation Have you seen this? ...

Below is a full draft based on your SSH startup and debugging process. It is ready for publication on a technical blog. Run SSH Without sudo on Linux (User-Level sshd Guide) Subtitle / Abstract: When you have no root access in a lab or restricted server environment, how do you start SSH and access your account remotely? This guide shows how to run sshd in your user directory, enable key login, and connect remotely. ...

Title: Run sshd Without sudo: Troubleshooting, nohup, and systemd (User-Level SSH) Subtitle / Abstract: How to run OpenSSH as a normal user, solve common errors like “connection refused”, “password auth failed”, and start-limit-hit, and keep sshd alive using nohup or systemd. Target readers: Intermediate Linux users, researchers on shared servers, and anyone who needs SSH without root. 1. Background / Motivation In some lab or shared environments, regular users do not have sudo. The default sshd service cannot be started. If you need to: ...

Auto-start frp on Ubuntu: A Complete Guide Subtitle / Abstract Use systemd to run frp (Fast Reverse Proxy) as a managed service for stable, secure, and monitored auto-start on boot. Reading time: 8 minutes Tags: frp, intranet tunneling, systemd, auto-start, Linux, Ubuntu SEO keywords: frp auto start, Ubuntu frp config, frpc systemd, frps service, intranet tunneling Meta description: Step-by-step systemd setup for frp (frpc/frps) with config templates and troubleshooting. Target readers Developers deploying frps on cloud servers Intermediate Linux users building stable home/office tunnels DevOps and self-hosting enthusiasts Background and motivation Many developers use frp to expose internal services (SSH, web, NAS) to the internet. The problem is that running ./frpc -c frpc.ini manually is inconvenient and unreliable after reboot. ...

Windows + WSL2 Port Forwarding Guide (Access Flask 5000) Prerequisites You are using WSL2 (Ubuntu or another Linux distro) The Windows host can access the LAN (Wi-Fi or Ethernet) A Flask service is running inside WSL2 and listening on: app.run(host="0.0.0.0", port=5000) host="0.0.0.0" is required; otherwise external access will fail. Step 1: Check the WSL2 IP In WSL2: ip addr show eth0 You should see something like: inet 172.26.209.37/20 Record the IP after inet (here: 172.26.209.37). This is the WSL2 internal IP. ...