lk/README.md

35 lines
1.4 KiB
Markdown
Raw Normal View History

2020-01-02 00:30:38 +00:00
This is a list of quickstart guides for Linux programs.
2020-01-02 00:04:35 +00:00
# Purpose
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.
3. The scripts should get someone up and running in the shortest possible time.
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.
2020-01-09 13:18:50 +00:00
5. No presumed knowledge (except for information held in `basics.md`).
2020-01-05 12:33:53 +00:00
6. Easy reference.
As little knowledge as possible should be presumed, with required knowledge being internally linked. If general knowledge is presumed, it should be placed into a file named 'basics'.
2020-01-02 00:04:35 +00:00
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
Systemd is taken as a default. Non-systemd commands we relegate to their respective distros, e.g. runit for Void Linux.