Die echte Manpage

Die echte Manpage

Linux- und Unix-Systeme haben unter anderem den Vorteil, mit Man-Pages eine umfassende Dokumentation mitzubringen. Als Lektüre taugen die wenigsten, aber als Referenz sind sie unabkömmlich.

Wer mit dem Versionsverwaltungssystem git arbeitet hat sich vielleicht schon mal durch git-Manpages gekämpft. Die sind auch umfassend und informativ, wimmeln aber dermaßen von Fach-Chinesisch dass man wirklich eine Menge Vorbildung braucht um die Informationen wirklich abgreifen zu können. Ich persönlich sehe gerne auf diesen Überblick, totalen Einsteigern hilft diese Seite.

Um so lustiger, dass jemand einen Generator gebaut hat um fiktive git-Kommandos zu dokumentieren. So wird man sonst nirgends Beschreibungen von git-drug-tip(1) oder git-proofread-archive(1) bekommen… :-D

Traumhaft, oder?

Traumhaft, oder?

Ich habe schon viel zu oft in Projekten gearbeitet in denen eine ordentliche Sourcecodeverwaltung entweder nicht möglich, nicht sinnvoll oder sonstwie nicht gewollt war. Dabei weiss ich die Vorzüge definitiv zu schätzen, ich habe meine privaten Projekte fast komplett in SVN oder Git.
Heute habe ich ganz andere Vorzüge entdeckt: mit einer geeigneten Darstellung kann ein Source-Repository wirklich ästhetisch ansprechend wirken. Und damit meine ich nicht nur Code Poetry. Dazu gibt es das Tool gource, dem wirft man das Repository vor und es macht einen Film daraus. Wirklich schick, wie ich finde. Sowas könnte ich mir prima als Bildschirmschoner vorstellen.
Nur gegen meine eigenen Sourcen brauche ich das vermutlich nicht auszuprobieren. Ich habe in der Regel nur einen Trunk, und ich bin meistens auch alleiniger Contributor.