Ujeté vlaky, OpenGL a můj dokumentační projekt

14.12.2008 23:24 | Přečteno: 1838× | poslední úprava: 14.12.2008 23:24

Vlak ujíždí a houká a k nebi stoupá dým
Nepřítomnej pohled, na silnici jeho stín... -- Tleskač: Krutej John

Není to tak dávno, co jsem obdržel v práci za odměnu poukázku do obchodu, kde jsem si vybral moc hezkou knížku: český překlad OpenGL - průvodce programátora (slavný Red Book). Toužil jsem po ní už nejméně deset let. Mé srdce se zachvělo radostí, když jsem ji dostal a otevřel...

Je to opravdu tak dobrá kniha, jak jsem si myslel. Kdybych ji měl tehdy, před těmi deseti lety, mohlo ze mě něco být, mohl jsem se naučit dělat pořádné hry a stát se v oboru velkým zvířetem. Teď je to jen pomníček promarněné šance. Co se v ní dočtu, už většinou vím, ale je pozdě - potřeboval jsem to vědět mnohem dřív. Vlak ujel. Proč všechno, po čem toužíme, přichází tak pozdě, že už je to úplně naprd?

Když už jsem u těch ujetých vlaků: jak si možná někdo vzpomene, před cca třemi lety jsem začal zpracovávat linuxovou dokumentaci ve formě wiki, o které jsem se domníval, že by se mohla stát takovým informačním uzlem pro vývojáře Linuxu, jako je MSDN pro vývojáře Windows. Jak jednoduché všechno vypadá na začátku...

Tehdy byly manuálové stránky opravdu v dezolátním stavu, dokumentace libc naprosto zastaralá a za mizernou kvalitu, respektive neexistenci, jakékoli dokumentace nám spílali na konferenci LSB. Tak jsem se do toho dal. Problém byl asi v tom, že jsem použil vlastní wiki engine - ten sice splňoval přesně mé požadavky, ale psát dokumentaci a současně kódovat wiki je pomalé. Kurevsky pomalé. Dny a měsíce vesele letěly a postupně všichni zapomněli. Mezitím byly oživeny linuxové manuálové stránky; přišla nová krev a teď jsou aktivně vyvíjeny. Což je samozřejmě dobře. Jen mám pocit, že tím se můj projekt stal dalším pomníčkem. Kdo pozdě chodí...

Nicméně: kdo chce vidět pomníček, je zde. Stále na něm pracuji; před měsícem jsem se rozhodl vykašlat na tvorbu vlastní wiki a přiohnul si MediaWiki. Bylo to dobré rozhodnutí, jen jsem na to holt měl přijít trošičku dřív. Kdyby se někdo chtěl přidat, je vítán, ovšem u vědomí toho, že možná ten vlak už ujel. Ale když už jsem se s tím tak patlal, tak se aspoň pochlubím (tak trochu jako kočka, která zanechá uprostřed obýváku pošlou krysu).

       

Obrázky

Komentáře

[kralyk z abclinuxu]

S tím OpenGL to je ujetý vlak proč? - Protože teď nemáš ty příležitosti co předtím, nebo protože se OpenGL dostává oproti DirectX do stagnace? (což možná není pravda)

[Bluebear]

Protože už nejsem tak mladý, jak jsem býval.

OpenGL je v pohodě, stále se vyvíjí; momentálně je na tom sice o trochu lépe DirectX, ale principy jsou víceméně stejné a s nástupem shaderů a programování přímo na kartě už jsou si i ta API velmi podobná.

[Luk]

Na tom tvém lindevdoc bych možná občas pracoval, nebýt té nešťastné události, kdy mi záhadným způsobem (zřejmě z mé blbosti, že jsem to neuložil) zmizela skoro dvouhodinová práce. Už jsem nikdy později nezískal motivaci se do toho znovu pustit.

[anicka]

Já si pořád říkám, že až dostuduju, a budu mít víc než -10 hodin času týdně, tak s tím taky pomůžu. To je ale ještě záležitost několika let...

...hele, Medvěde, nechceš o tom konečně říct víc než těm pěti a půl lidem? Ona je slušná šance, že bys to pak nemusel dělat sám

[kralyk z abclinuxu]

Jo, třeba i v zahraničí, tam nebyly nějaký odezvy?

[Bluebear]

...hele, Medvěde, nechceš o tom konečně říct víc než těm pěti a půl lidem? Ona je slušná šance, že bys to pak nemusel dělat sám

Pokusím se; vzhledem k tomu, že teď mám víceméně fungující wiki, tak to má větší smysl. Předtím jsem nebyl schopen dostat mou wikinu do stavu, kdy by byla použitelná pro kohokoli jiného než mě a osoby, kterým pečlivě vysvětlím, kam nesmějí šlápnout.

[Bluebear]

nebýt té nešťastné události, kdy mi záhadným způsobem (zřejmě z mé blbosti, že jsem to neuložil) zmizela skoro dvouhodinová práce

Hádám, že to vypršel session cookie Tohle byl známý problém staré wiki a jeden z důvodů, proč jsem se nikdy neodhodlal lákat více lidí - pokud člověk přesně nevěděl, co musí nebo nesmí v dané situaci udělat (a to jsem víceméně věděl jen já sám), dělalo to divné věci.

[YYY]

Procetl jsem si par clanku na te wiki a musim uznat, ze je to docela pekne pocteni... Ale neni tam nic, co bych neznal... Treba nekdy neco sesmolim, jestli na to nezapomenu(bohuzel mam vypadky kratkodobe pameti). Jinak preju hodne stesti a chuti v pokracovani.

[Aleš Kapica]

Smutné čtení.

Pokud jde o knihu - jde jen čistě a pouze o tvoji blbost, protože kdybys po ní skutečně prahnul, tak by ti před těmi deseti lety nebylo líto do ní investovat. Tak si nestěžuj.

A pokud jde o dokumentaci. Kdybys hned od samého začátku využil projet Mediawiki wikibooks, který je přesně pro takové účely. Tak bys teď neměl ten pocit marnosti. Ostatně naprosto nechápu, proč jsou lidi ochotni investovat svůj čas a nadšení do nejrůznějších parciálních dokumentačních projektů. U nichž je pouze otázku času kdy půjdou z nejrůznějších důvodů do kytek.

Mediawiki je dost velký kolos na to aby ji nechali padnout a je dost známá na to aby na tamní věci natrefili potencionální pokračovatelé.

[Bluebear]

Pokud jde o knihu - jde jen čistě a pouze o tvoji blbost, protože kdybys po ní skutečně prahnul, tak by ti před těmi deseti lety nebylo líto do ní investovat. Tak si nestěžuj.

Já bych do ní investoval rád, ale nemohl jsem ji sehnat. Neměl jsem ještě tolik zkušeností s nákupem věcí v zahraničí a před deseti lety to taky nebylo tak jednoduché jako dnes.

Ostatně naprosto nechápu, proč jsou lidi ochotni investovat svůj čas a nadšení do nejrůznějších parciálních dokumentačních projektů. U nichž je pouze otázku času kdy půjdou z nejrůznějších důvodů do kytek.

To bude tím, že na začátku takových projektů většinou není po ruce brouk Pytlík, který všude byl, všechno ví a tudíž může přesně poradit, který projekt má smysl a který je odsouzen k zániku.

[Aleš Kapica]

Ad kniha, to jsem vcelku schopen pochopit. Sám jsem si některé knihy schrastil až po nějakém čase. Naštěstí je však nepovažuji za natolik zásadní, že bych tím omezil svůj intelektuální rozvoj.

Ovšem na posouzení, do kterého projektu má nebo nemá smysl investovat čas není třeba Brouk Pytlík, ale selský rozum a trocha toho kritického myšlení. Linux je toho názorným příkladem. Ještě před třemi lety bylo zcela běžné (a to i v rámci uživatelů linuxu!) přesvědčení, že linux nemá na desktopu šanci. U lidí disponujících výše uvedenými vlastnostmi však již na desktopu win převálcoval.

Drobná perlička. Dnes dopoledne mi psala kamarádka jestli "je normální, že media player nebere DVD z obchodu (hlásí, že nemá dekodér) a u vypal v avi jede jen zvuk?" Za ty tři roky co používá pouze linux nějak pozapoměla, že se musí do čerstvých Win řada věcí postahovat a doinstalovat odjinud, aby byly vůbec k použití.

[anicka]

Hele, že máš chování řeznického psa a jsi pan chytrý, už tady dávno víme všichni.

Všichni taky známe Bluebeara a tudíž víme, že zatímco my otatní se Ti vysmějeme, jemu můžeš těmi kecy doopravdy ublížit. Nebyl bys prosím tak laskav a nevybral si na to hnusné rytí a deptání někoho jiného? Klidně se hlásím dobrovolně. Za posledních pár dnů mi umřel pes a počítač, internetový troll mě tudíž absolutně nemůže vyvést z míry

Druhá věc je, že to nechápu. Když někdo popíše ostatním, jak se poučil ze svých chyb a Ty se mu kvůli těm chybám vysměješ a uděláš z něj hlupáka, ukazuje to především na to, co si zřejmě myslíš sám o sobě - proč bys jinak měl potřebu se po něm vozit a ukazovat světu, že Tobě je to přece jasné? Proč bys ho odsuzoval za nějaký čin, o jehož důvodech vůbec nic nevíš? (Jak můžeš tušit, co dělal Bluebear před deseti lety?)

[Aleš Kapica]

Šmarjá! Co je proboha hnusného na tom, že jsem konstatoval že je to smutné čtení?! Tak afektovaný komentář bych teda vážně nečekal. Ostatně, soudě dle jeho komentáře je to osoba která umí komunikovat sama za sebe a nemá kuří oka tak citlivá jak se domníváš.

[anicka]

Vida, tak je to mnohem lepší Mimochodem, ta hláška o "smutném čtení" byla tou nejneškodnější částí celého příspěvku

Každopádně, jsi teď v Praze, tak se někdy stav a uvidíš. Možná si pak aspoň uvědomíš, že tam na druhé straně jsou živí lidé, a že každý nemá napsané v profilu, čím trpí jeho skutečné já z masa a kostí. Zrovna tak možná přijdeš na to, že když někdo v odpovědi nehne ani brvou, neříká to nic o tom, co to udělá s jeho zbytkem dne. (Možná je dneska zrovna dobrý den, ale to nikdy nemůžeš vědět. Už jsem viděla i tu horší možnost.)

Rozebírat tu přede všemi podrobnosti by bylo hloupé (byť Bluebear už na sebe spoustu věcí ve starších diskusích prozradil sám), takže jestli chceš, zastav se u nás.

[Aleš Kapica]

No, především nevím, kde to je "u nás". A času je tak proklatě málo - zvláště teď koncem roku. Plkání na abclinuxu.cz provozuji především pro ukrácení času než něco dojede, nebo přijde nápad či chuť k práci. Zkrátka času, který ať tak nebo tak musím odsedět u kompu. Určitě ne proto, že bych měl radost z toho jak jsem někoho vydeptal.

[anicka]

U nás je tady.

Plkání na abíčku provozujeme pravděpodobně všichni ze stejných důvodů. Pro některé z nás pak ale po některém plkání nemusí být vůbec snadné se k té práci vrátit.

[Aleš Kapica]

Ty jo, jakže to bylo? "Žižkovu a Libni, zdaleka se vyhni"? Ale dosti popichování. Pro mě to je skoro na celodenní výlet, protože dělám přesně na opačné straně (bráno od místa bydliště). S přihlédnutím k pracovní době a povinnostem vůči potomkovi.. Tak nejdřív příští rok, nebo zítra s ním

[anicka]

Jojo, tak nějak. Tuhle znáš?

Vysočany, Libeň, to jsou pražský čtvrti,
kdo sem večer zajde, ten je synem smrti,
sem nejezdí žádný auta s turistama,
sem se slušná holka nevodváží sama.

(Písničku napsal Jiří Dědeček.)

Možná budeme mít zase na jaře den otevřených dveří, pak tady bude k vidění víc než nebozí vývojáři vyčerpaní releasem A možná to bude bavit i potomka

[Aleš Kapica]

Tak při našem dni otevřených dveří jsem měl nejspíš zatmění mysli. Přesto že jsem byl v pokušení vzít ho sebou, jsem to nějak zasklil. Pak mě to děsně mrzelo, protože mimo jiné tu ukazovali ty legové robůtky. Má jednoho slíbeného, až se naučí číst a psát, aby s tím taky něco mohl dělat. Ovšem byl jsem uklidněn, že si jich užije do aleluja, protože prý má být jejich programování od příštího roku součástí výuky.

[Aleš Kapica]

Jinak mě pochopitelně těší, že jsem považován za takového všeználka, sám takové mínění o sobě nemám. Ovšem pokud si chceš skutečně naplno užít mého rýpání, není nic snazšího, než se domluvit s Markem.

[trekker.dk]

Všichni taky známe Bluebeara a tudíž víme, že zatímco my otatní se Ti vysmějeme, jemu můžeš těmi kecy doopravdy ublížit.

Jo? Jakože mu třeba vybuchne hlava?

[Deleted [8409]]

Chtěl bych se jen zeptat, jestli vám Wiki připadá jako dobrý základ pro dokumentační projekt. Je jasné, že se tam vytváří dobře stránky a celkem dobře se propojuje, ale mi osobně se třeba v MSDN vyhledává líp. Chybí mi prostě ty stromové hierarchie, atd :)

[Luk]

Ty stromové hierarchie jsou důležité, ale k tomu by měl snad jít Wikiengine přihnout, ne?

[Aleš Kapica]

K tomu mám jen jednu připomínku. Když už někdo chce něco "přiohýbat" tak by to měl především dělat tak, ať je to k užitku Mediawiki jako celku. Také jsem potřeboval mediawiki trochu přiohnout. Rozšíření které bylo k dispozici mělo svoje mouchy a tak nakonec jsem napsal vlastní AccessControl

[Josef Kufner]

Mediawiki stromeček umí. Jen to je defaultně vypnuté či co.

[kralyk z abclinuxu]

ale mi osobně se třeba v MSDN vyhledává líp

A ten je open-source? Dá se někde stáhnout? Anebo něco, co by fungírovalo stejně?

[Luk]

Stačí se inspirovat. Už jsem tu o tom mluvil aspoň stokrát. Proč vymýšlet vymyšlené? Já vím, pro někoho je nejskvělejší formát info a na nějaké stromečky zvysoka s..., ale například já patřím k té druhé skupině - tedy k té, která má raději HTML dokumentaci, ať už v podobě známé z MSDN nebo aspoň třeba z Javy.

[Deleted [8409]]

Nechápu proč ze sebe děláte hlupáka. Dokumentaci na MSDN si může číst každý a navíc jsem mluvil o stromové struktuře. To že mě napadlo jako přirovnání MSDN je snad špatné? Mě osobně baví programovat i pro Windows a na WinAPI jsem vyrůstal.

Takže ještě jednou pro králíka - orientuje se mi líp ve stromové struktuře než v dlouhém seznamu, spokojen?

[kralyk z abclinuxu]

Ale já myslel úplně něco jiného! Asi jsem se špatně vyjádřil...

Takže znovu a (snad) lépe. Ten kód, na kterým fungujou stránky MSDN (čekal bych nějaké asp), se dá někde stáhnout? Nebo něco, co má podobné UI?

p.s. Taky mě osobně baví programovat (i) pro windows. Nejraději dělám cross-platformové řešení, pokud je možné...

[Deleted [8409]]

Aha tak to se omlouvám, nepochopil jsem vás

[Deleted [8409]]

Ještě bych doplnil že nevím jestli se to dá stáhnout, asi ne :)

Ale nějaký podobný projekt jako je MSDN bych pro Linux uvítal. V linuxu je k dispozici ohromné množství knihoven a mít je k dispozici všechny na jednom místě s dobrou dokumentací by byla výhra. Zatím jsem sice vždycky našel co jsem hledal, ale možnost zrychlit práci je tu vždy :)

PS: Já mám rád také cross platform aplikace a to je i důvod proč chci v životě dokončit jeden GUI toolkit pod BSD licencí

[Josef Kufner]

Pokud máš Debian, nainstaluj (asi) dhelp a koukni na http://localhost/doc/HTML/

[stativ]

Náhodou lindevdoc mám pořád v záložkách.

[ʚĭɞ 🍉]

No a dál...