howtos/PROJECT.md

Project: howtos

Motivation

Scattered notes, bookmarks, and history | grep are poor substitutes for well-organized reference material. This project centralizes practical knowledge into a consistent, maintainable format.

Goals

• Provide quick-reference guides for daily tools and workflows
• Maintain a consistent structure across all topics
• Keep content concise and actionable — no tutorials, just references
• Make it easy to add new topics via a template

Architecture

Flat file collection — no build step, no dependencies. Plain Markdown rendered by any viewer (terminal, browser, editor).

topics/<topic>.md     # Individual howto files
docs/TEMPLATE.md      # Template for new topics

Dependencies

None. Plain Markdown files. Optionally viewed with glow, bat, or any Markdown renderer.

Non-Goals

• Not a tutorial site or blog
• Not a wiki with cross-linking
• Not auto-generated from --help output