Nezlobte se, ale pokud říkáte jeden dokument, pak si pod tím představuji jedinou knihu, případně PDF či HTML soubor. Skupinu HTML stranek třeba i zabalených do CHM nepovažuji za dokument. Proto jsem se divil, že se vám nelíbí rozdělení dokumentace FB na dokumentů, protože i skupinu PDF lze prolinkovat do jediného "dokumentu". Mimochodem i PDF umožňuje hypertextové odkazy v rámci dokumentu, a zmíněné dvě knihy toho hodně využívají. Mezi PDF a HTML tedy nemusí být až takový rozdíl, nicméně uznávám, že vytvořit HTML je jednodušší.
Nicméně Dokumentační projekt Firebirdu používá DocBook, a produkuje tedy jak PDF, tak čistě HTML verze. Bohužel knihy Firebird Reference a Using Firebird jsou ve FrameMakeru, a převést je do DocBook formátu není až taková trivialita. Základní konverze byla sice strojová, ale vyžaduje to drobné manuální korekce. Vzhledem k rozsahu je to vleklá nudná práce, kterou je jen málo kdo ochotný dělat. Jakmile ovšem bude dokončena, budete mít rázem cca 1200 stránkovou dokumentaci k Firebirdu dostupnou ke stažení či brouzdání přímo na webu projektu.
Ohledně nedostatku dokumentace a její "roztříštěnosti" se bohužel často zapomíná, že:
a) Napsat dobrou dokumentaci je zdlouhavá práce, která v případě technické dok. vyžaduje navíc jak znalost problematiky, tak i schopnost jasně a srozumitelně psát. Dobrých tvůrců *ucelené* dokumentace je tedy jako šafránu, a prakticky nikdo z nich není ochoten to dělat úplně zadarmo (ne že by se vydávání tech. knih nějak zvlášť vyplatilo, ale lepší něco než nic). Proto např. dokumentace kterou vytváří IBPhoenix jde přednostně na placené Developer CD (verze Subscription je Firebirdí verze MSDN), a je uvolněna až se spožděním.
b) Dokumentační projekt si nemůže přivlastnit práci jiných, aby mohl vytvořit jediný superhyperdokument, pořád je zde něco jako autorská práva. Proto je dokumentace poněkud "roztříštěná", a člověk musí informace dohledávat z drůzných zdrojů. To nejlepší co zatím můžeme nabídnout je nashromáždit odkazy na nejdůležitější dokumenty na jedno místo. Obecně je za toto místo uznáván web www.ibphoenix.com nebo .cz
Ano, volně dostupné dokumentace je dost, jsou tu ale dvě ale. Na to, abyste se seznámil se základními funkcemi Firebirdu vydáte několikanásobek času, než u jiných srovnatelných databází, který strávíte hledáním a dáváním si různých střípků informací dohromady.
Tenhle problém "zatím" řeší knihy tištěné či na Developer CD. Až se dokončí konverze, budou dvě základní knihy dostupné i volně na webu projektu.
A to ještě příznivě podpořeno tím, že naštěstí tu máme slušnou příručku od Borlandu k Interbase.
Ta se běžně nedá legálně sehnat, je třeba ji koupit spolu s InterBase. Volně dostupná je pouze dokumentace k IB 6.0, a to jen díky tomu, že nad tím Borland zavírá oči.
Druhé ale je, že se velmi těžko pátrá po dokumentech, které by trochu popisovaly Firebird do hloubky. Byl bych rád, kdybyste mě zejména v tomto bodě přesvědčil o opaku, a já rád vše odvolám.
Mno, zrovna některé knihy jdou překvapivě hodně do hloubky, a popisují i témata které jiné dokumenty moc neřeší (funkce optimalizátoru, struktura databáze, vnitřní mechanizmy funkce serveru apod.). Jinak na webu www.ibphoenix.com jich je celá hromada (bohužel ne nijak přehledně strukturovaná, navíc jsem si teď všiml, že na nedávnou sérii článků pro expery od Ann Harrison není odkaz jinde než v news archivu, což napravíme). To vše a mnoho dalších je součástí Firebirdího MSDN.
Já vím, že dost toho je to placené, ale dostupné to je, a je to průběžně uvolňováno pro Dokumentační projekt.
Koupení knihy nic neřeší, protože zkrátka rozsah jakékoli knihy může být jenom zlomkem toho, co může být v kvalitní dokumentaci. Kniha je dobrá věc, ale neřeší vše.
To je s prominutím pěkná hloupost. Pokud chcete začít dělat např. v C#, nemusíte si přece hned kupovat MSDN, stačí *dobrá* kniha. Ani např. dokumentace k PHP nebo Pythonu neobsahuje "úplně všechno". A i kdyby obsahovala, tak tím spíš se mi vyplatí nějaká dobrá kniha, která mi jasně a přehledně podá to podstatné co potřebuji (sám mám pár knih o PHP a Pythonu, a nikdy jsem investice nelitoval). Z osobní zkušenosti vím, že taková "úplná" dokumentace je dobrá tak leda jako referenční příručka, kde rychle najdu to co hledám, ale musím nejdřív vědět co hledám. Na učení a informace které bych měl o daném tématu znát mě vždy upozornily spíš knihy.
