lk/README.md

50 lines
1.5 KiB
Markdown
Raw Normal View History

2022-01-16 19:28:02 +00:00
---
title: "Knowledge Base"
---
2021-05-15 14:10:30 +00:00
# Linux Knowledgebase
2020-01-02 00:04:35 +00:00
2021-05-15 14:10:30 +00:00
This is a list of quickstart guides for Linux programs, designed to get the user up and running as fast as possible.
# Style
2020-01-02 00:04:35 +00:00
1. Minimal theory, maximum practical.
2. The statements should go in order of how likely they are to be used: if `git add` has to be used by everyone, then it should go first.
2021-05-15 14:10:30 +00:00
3. Documents should be similar to well-documented scripts.
2020-01-02 00:30:38 +00:00
4. No explanations for the program. This isn't an introduction or advert, it's a guide for someone who already wants to use a program but doesn't know how.
2021-05-15 14:10:30 +00:00
5. It's better explain how to set something up three times than to link or reference a setup.
6. If general knowledge must be presumed, it should be placed into a file named 'basics'.
2021-02-23 22:10:01 +00:00
### Example
```
How to see which websites you're actively accessing:
> ss -tr dst :443
```
2020-01-02 00:30:38 +00:00
# What's wrong with everything else?
## Man pages
- Orders items by the alphabet rather than by relevance.
- Often presumes you know everything except that one program.
- Often written in the 80's, and it shows.
- Zero respect for your time.
2020-01-05 12:33:53 +00:00
## curl cheat.sh/
2020-01-02 00:30:38 +00:00
- Doesn't have the programs I like.
- Too short to get you started on many programs.
2020-01-26 16:08:17 +00:00
- Poor understanding of priority (`git stash` is covered before `git commit`).
2020-01-02 00:30:38 +00:00
2020-01-02 02:49:45 +00:00
# Current State
2020-01-02 00:30:38 +00:00
2020-01-02 02:49:45 +00:00
This started as a few personal notes, and will probably continue to look like that for some time.
It's a bit of a mess.
2020-01-02 18:24:30 +00:00
2022-01-26 22:35:07 +00:00
Systemd is taken as a default.
Non-systemd commands we relegate to their respective distros, e.g. runit for Void Linux.