31
veIox
159d

docker documentation is terrible. Mf'ers seem allergic to giving actual functional examples.

Watch me generate a 1-to-1 copy of the docker compose docs (real & true):

`docker compose --help > docs.html`

Comments
  • 10
    Solid first rant!

    Try using grep.app to find real world examples. That's how I learned it.
  • 1
    @lungdart Wow, that is really useful! thank you!
  • 0
    Any time.
  • 2
    Truly - they haven’t updated it in years
  • 0
    @lungdart github rip, but not full snapshot as i couldn't even find my own code on github with it.
  • 2
    You just reminded me of how I need to deal with docker again, really soon. On our other server I've been able to use LXD/LXC to get by... not looking forward to it.

    I'm pretty sure there's some sadistic maintainer somewhere thinking up new ways to over-explain the simple/obvious yet come up with the least helpful examples possible for any complexities... laughing sinisterly alone in the dark.
  • 1
    i noticed this and was thinking of making a series of aliases for it. i shouldnt need 'docker ps -a' to list my containers
  • 1
    @fullstackcircus I owe most of my sanity to aliases... when I'm in hyperfocus coding (>90% of the code) i, ironically af, have a ridiculously hard time thinking of shit in english, and quite a timesink for any naming scheme that makes sense to !==me.

    Aliases make that all better...
    especially counting my odd use of UK spellings (as I'm fully American-- 18-21 worked for a UK company).
  • 1
    @fullstackcircus
    Do you know a simple way to explain aliases to a major newbie to dev... and computers...?

    It's the next thing I need to teach, but I learned it before the internet had many dev guides(~25yrs ago), from common (to me) sense.
  • 0
    @awesomeest its really not much different than a function - bringing together one or more commands / lines to a single easy to remember command

    but bash has functions too... which i also use as aliases 😂, typically when i need to pass arguments in a certain order
  • 0
    @fullstackcircus yea... but he's a HUGE newb (not his fault)... like since he never touched/knew anyone that even had access to a non-android computer... first real computer encounter was a $5k RHEL9 server (VERY local to me~4ft atm) remotely on an android tablet from Myanmar (i needed him to enter in my written server change logs to a text log)... then i got him a real (essentially mini but plenty of power for his needs... MM import restrictions) Win11 pc... just kinda.... uhh.. 'forgot' to mention the vast majority of GUI functions and dropped him a big Win/DOS/linux commands list req'd learning.

    Recently (few weeks ago) mentioned he thought itd be easier to do X in GUI, so i said sure... next thing i gave him was to make it simple for me to troubleshoot an audio issue... just use GUI, dev manager, get every audio dev(or things with the yellow triangle) and send me a text file with all the event logs. maybe a bit mean, but he chose to find/learn new wmic uses ;) no more GUI talk.
Add Comment