#976626 RFP: golang-github-cheat-cheat -- cheat allows us to create and view interactive cheatsheets on the command line

#976626#5
Date:
2020-12-06 04:26:39 UTC
From:
To:
* Package name    : golang-github-cheat-cheat
  Version         : 4.2.0
  Upstream Author : Chris Allen Lane <chris@chris-allen-lane.com>
* URL             : https://github.com/cheat/cheat
* License         : MIT License
  Programming Lang: Golang, Shell
  Description     : cheat allows us to create and view interactive cheatsheets on the command line


cheat allows us to create and view interactive cheatsheets on the
command line. It is designed to help remind *nix system administrators
of options for commands that they use frequently, but not frequently
enough to remember. Using cheat, we can define our own custom
cheatsheets or use community sourced cheatsheets[1].

[1]: https://github.com/cheat/cheatsheets

#976626#10
Date:
2022-08-08 21:47:49 UTC
From:
To:
This seems very similar to the tldr package:

https://packages.debian.org/stable/tldr

See https://tldr.sh/ for examples.

Francois

#976626#15
Date:
2022-10-01 16:57:35 UTC
From:
To:
Yeah, so tldr is similar, but cheat has a number of improvements, from
my perspective.

 1. it supports multiple collections of cheats, so you can have your own
    set for your site-specific scripts

 2. the storage format is YAML instead of markdown (depends on the taste
    i guess)

 3. that enables support for tags and other niceties that harder to do
    in markdown

Overall, cheat doesn't try to replace manpages, it seems like a
different thing. I find the project quite interesting and wonder if we
could use it at work to document stuff quickly that would otherwise be
lost in our wiki.

(because, of course, we don't write man pages for our own tools, which
is probably the problem in the first place here...)

(also, one of the things i find silly with tldr is exactly that: it's
basically rewriting the EXAMPLES section of manpages. instead of working
on tldr, people should contribute EXAMPLES to the manpages!)

(I guess the same argument could be made for cheat as well, of course,
but it feels like it serves a different purpose.)

ymmv

#976626#20
Date:
2022-10-01 17:46:24 UTC
From:
To:
Thanks for those details. I had not looked into cheat all that much, but now
I'm curious to check it out!

Francois