@ubernauten ihr klingt nach einem sehr netten Laden bei dem man gerne arbeiten und/oder Kunde/Kundin sein möchte.
Was ich bei Anleitungen im Netz mit Terminalbefehlen meistens vermisse sind Erklärungen zu den Parametern die man mit gibt. Irgendwas ins Terminal copy pasten ist die eine Sache, zu verstehen warum und weshalb die andere.

@Bobo_PK @ubernauten
Dokumentationen werden monströs, wenn jeder Parameter erklärt wird. Dafür, dass die Parameter sowieso in den manpages erklärt werden.

Meiner Erfahrung nach, ist die Schnittmenge aus Leuten die sich weigern in Manpages zu schauen und jenen die eine passende Erklärung in der Dokumentation lesen sowieso nahe 0.

@gom @ubernauten ich wusste damals nicht mal was eine manpage ist oder wie ich die Hilfe aufrufe. Die mit zu verlinken würde in meinen Augen helfen. Ist wie Quellenangaben, lesen auch die wenigsten, aber alle die es mehr interessiert.

Follow

@Bobo_PK @gom Ihr habt beide irgendwo recht. Zu viel bläht nur auf, zu wenig macht es für manche unbrauchbar. Da die Balance zu finden ist nicht einfach, wir geben uns aber Mühe.

· · socialhub · 2 · 0 · 1

@ubernauten @gom "Die Wahrheit liegt irgendwo dazwischen"

Ist bei einer heterogenen Nutzerinnenschaft halt echt nicht einfach.

@Bobo_PK @ubernauten
Fixe Idee, Script basteln, welches die Shell Schnipsel parst und die verwendeten Parameter der Befehle aus den manpages extrahiert. Nach Klick blendet es die Dokumentation zu den Parametern ein. Erspart zumindest den Faulen selber "man foo" einzutippen.

@ubernauten ggf. könnte man die Erklärung zu den Parametern ja einfach optional zum aufklappen mit reinschreiben? :) @Bobo_PK @gom

Sign in to participate in the conversation
Uberspace Mastodon

This server is for internal use only at the moment (Imprint)