Pijul: A intuitive VCS unlike Git that's based on sound theory of patches

Re:Pijul: A intuitive VCS unlike Git that's based on sound t... by kkarakk on Saturday September 26, 2020 @06:37AM (#24597755)

sorry i'm gonna sound like i'm making an argument for authority but why do man pages have to appeal to the "average" person anyways? complex tasks require complex explanations to avoid weird hangups/errors.

every time i see people complain about the complexity of manpages i always wonder what their work looks like if manpages is the blocking issue to their understanding of a tool

[ Parent | on HN ]

Re:Pijul: A intuitive VCS unlike Git that's based on sound t... by ahartmetz on Saturday September 26, 2020 @08:57AM (#24598468)

I would agree that most manpages are pretty useful and that they don't necessarily need to be tutorials (it would be against Unix traditions, haha). Git's manpages and CLI are just a particularly bad word soup.

[ Parent | on HN ]

Re:Pijul: A intuitive VCS unlike Git that's based on sound t... by jl2718 on Saturday September 26, 2020 @09:17AM (#24598590)

TODO: man page search engine with semantic term substitution (e.g. Bert). Possibly trained on stackoverfow.

[ Parent | on HN ]