fa82dd816d
Disable MD060 (table column alignment) and MD032 (list blank lines). Add language tags to bare fenced code blocks (MD040).
32 lines
953 B
Markdown
32 lines
953 B
Markdown
# 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).
|
|
|
|
```text
|
|
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
|