Post Ax44eUP6UdiSszR7uS by sally@freesoftwareextremist.com
 (DIR) More posts by sally@freesoftwareextremist.com
 (DIR) Post #Ax2eQKIuSJlZXcAJQu by sally@freesoftwareextremist.com
       2025-08-10T21:08:00.352620Z
       
       0 likes, 0 repeats
       
       Wouldn't it be nice if certain projects documented their dependencies properly so they don't waste your time trying to figure out what libraries you need installed to compile something?
       
 (DIR) Post #Ax2eQLn4vdUc9THv60 by sicp@freesoftwareextremist.com
       2025-08-10T23:19:05.211388Z
       
       2 likes, 0 repeats
       
       @sally it took me like an entire day to figure out that a postgres module needed a specific configure line in order to build. their docs are good and say what to do, so maybe I'm the dummy here but they could've just defaulted it instead of sinking me in the hole of googling "x doesn't work" for hours on end
       
 (DIR) Post #Ax40JyaUfysQbKj9LE by sally@freesoftwareextremist.com
       2025-08-11T12:26:59.747045Z
       
       1 likes, 0 repeats
       
       @sicp I've seen very few projects that have good documentation, many commit the same mistake of assuming people already knows how stuff needs to be setup and configured, which if it was true would mean they don't need to read documentation in the first place.
       
 (DIR) Post #Ax40SSgieCOeGxgY4W by sicp@freebeerextremist.com
       2025-08-11T15:00:42.326197Z
       
       2 likes, 1 repeats
       
       @sally one of the best documented programs ever made is GNU Emacs. nothing else comes close, source code, manuals, docstrings, it's all there one or two clicks away. it's awesome
       
 (DIR) Post #Ax44eUP6UdiSszR7uS by sally@freesoftwareextremist.com
       2025-08-11T15:47:27.262591Z
       
       2 likes, 1 repeats
       
       @sicp Most stuff by GNU is amazingly well documented, specially Guix.
       
 (DIR) Post #Ax44vB0Prtwne8qWci by sicp@freebeerextremist.com
       2025-08-11T15:50:42.732262Z
       
       0 likes, 0 repeats
       
       @sally info is a great format too. waaaaay better than manpages. It's actually older than manpages, it first showed up on the original EMACS on ITS. It's pretty much the exact same format, at least if you loaded the ITS manuals onto modern Emacs it'd probably work.