I've written my first man page! https://github.com/Wilfred/difftastic/commit/cb63ca88303d3c8dffd763cf6e5772e45c045588
Troff syntax is new to me and a little hard to read -- apparently you shouldn't use blank lines. Turns out you can use pandoc to convert markdown to troff instead.
miniblog.
Related Posts
I've written a website that archives all my posts/tweets/toots/skeets across different microblogging platforms!
It's fun to be able to see similar posts that I wrote at completely different times. It also lets me edit links that have bitrotted.
I see people advocating for writing a FAQ, but I really struggle to write one from scratch.
The best FAQs are written as a response to, well, frequent questions.
How do you populate the initial FAQ?
I've written difftastic packaging instructions: https://difftastic.wilfred.me.uk/packaging_difftastic.html
The different distros have taken different approaches, so I'm trying to help with common gotchas — don't forget the man page!
Feedback welcome, especially if you've ever packaged something 🙂