libdrone jako důkaz¶
Zdokumentoval jsem celý systém předtím, než byl hardware hotový.
To není přiznání. To je záměr.
Co dokumentační stack je¶
libdrone.eu je kompletní dokumentační systém otevřeného hardware pro 6palcovou modulární dronovou platformu. Jeden člověk. Večery a víkendy. Výsledek:
- Soubor proměnných — jediný zdroj pravdy pro veškerou geometrii, každá hodnota na jednom místě
- Hlavní specifikace — kompletní systémová specifikace, téměř letecký standard
- Hardwarový dokument — každá komponenta, proč byla vybrána, kde ji sehnat
- Nákupní seznam — průvodce sourcing s alternativami a poznámkami o nákladech
- FreeCAD Cookbook — krok za krokem průvodce CAD prací
- Onshape Cookbook — referenční a ověřovací workflow
- Payload SDK — kompletní reference pro vývojáře standardu payload rozhraní GX12-7
- PRUSA Print Guide — nastavení tisku, výběr materiálu, poznámky ke kvalitě
- CadQuery generátor — 1 815 řádků parametrického Python generátoru pro všechny tištěné díly
Dokumentace je navržena tak, aby schopný cizinec — někdo, kdo mě nikdy neviděl, nikdy se mě nezeptal — mohl hardware kompletně reprodukovat z publikovaných souborů.
Proč jsem to takto postavil¶
Protože dokumentace napsaná po dokončení hardware je téměř vždy špatná.
Když dokumentujete při návrhu, najdete chyby. Měření, které nelze jasně vyjádřit ve specifikaci, je měření, které nebylo plně promyšleno. Proces, který nelze zapsat, je proces, který ještě není pochopen. Dokumentace není záznam designu — je součástí procesu návrhu.
Disciplína souboru proměnných zvláště: když každá hodnota žije na jednom místě, nemůžete si odporovat. Jste nuceni být přesní. Akt zapsání čísla jednou, správně, a jeho odkazování všude jinde je akt rozhodnutí.
Co to dokazuje¶
Že jeden člověk se správnými nástroji, správnou disciplínou a správným redakčním instinktem může produkovat dokumentaci na standardu, kterého většina inženýrských týmů nedosáhne s celým týmem.
Ne proto, že AI je magie. Protože architektura je ta práce, ne počet slov. Protože princip jediného zdroje pravdy se škáluje od technologického časopisu k hardwarové platformě bez změny. Protože zamilovat se do řemesla dokumentace — vůně dobře strukturované specifikace, uspokojení ze souboru proměnných bez rozporů — je skutečná profesní dovednost, která přináší skutečné výsledky.
Jedna otevřená mezera¶
Návrh „libdrone Pro" je plně specifikován. Dokumentace existuje. Payload rozhraní je definováno. Chybí někdo, kdo dokáže specifikaci převést do FreeCAD geometrie.
Pokud pracujete ve FreeCAD a myšlenka vybudovat referenční implementaci plně zdokumentované open hardware dronové platformy vás zajímá — ozvěte se.
Návrhové soubory, specifikace a soubor proměnných čekají. CAD práce je ten klíč.