Transitioning from manual to automated processes, and the role of documentation:
miniblog.
Related Posts
One interesting design choice in Emacs that I haven't seen in other editors: reserved shortcuts.
An Emacs extension shouldn't use F5 through F12, or Ctrl-c LETTER. This lets users configure their own shortcuts. https://www.gnu.org/software/emacs/manual/html_node/emacs/Key-Bindings.html
Does it exist elsewhere? I miss it in VS Code, where e.g. all the Fn keys are already assigned.
I've learnt a surprising amount by looking at how other people are packaging my difftastic project!
(1) A local copy of the manual doesn't have the version (OpenBSD packaging fixes this).
(2) One of my dependencies has been yanked (Void Linux packaging fixes this).
What's your preferred granularity of docs?
(a) A whole module on one page, e.g. https://pkg.go.dev/time, making search easy?
(b) A function per page, e.g. https://www.php.net/manual/en/function.time.php, giving more space for examples and See Also sections?
I'm torn, and I've seen both done well.
