Learn How To Create Awesome Tutorials on Utopian.io

Learn How To Create Awesome Tutorials for Open Source projects via Utopian.io

Utopian vytváří otevřenou ekonomiku, ve které
jsou přispěvatelé do projektů s otevřeným

zdrojem odměňováni za
svou cennou práci.

Práce může nabývat
různých podob.

Utopian proto vytyčil
několik kategorií,

do kterých mohou lidé
přispívat svou prací.

Jednou z těchto
kategorií jsou návody.

Vzdělání je jádrem inovací.

Utopian podporuje rozvoj kvalitních vzdělávacích
materiálů k podpoře open source komunity.

Návody spadají do
této iniciativy.

Je zásadní, aby
návody byly přínosné.

Příspěvky musejí být zajímavé, naučné
a s originálním obsahem a obrázky.

Podívejme se blíže na to,
co dělá návod vynikajícím.

Utopian se snaží udržet konzistentí formát
a kvalitu všech nahraných video návodů.

Abyste toho mohli dosáhnout, Utopian poskytl
prostředky k tvorbě konzistentního obsahu.

Zaprvé, Utopian zapracoval důkladný
soubor obecných pravidel a instrukcí,

které platí pro
všechny kategorie.

Všichni přispěvatelé
se jimi musejí řídit.

Utopian také vytvořil sadu
pokynů specifických pro návody,

které pomůžou autorům vytvářet
naučně přínosný obsah

a moderátorům pomůžou při
posouzení tohoto obsahu.

Podívejme se na některé
pokyny určené pro návody.

Návody se musejí zabývat koncepty, které
nejsou snadno uchopitelné běžnými uživateli.

Návody o elektrických obvodech nebo konstrukci
elektronických modulů nejsou pro Utopian vhodné.

Vaše lekce by měly poskytnout
dovednosti a znalosti,

které lze využít v
široké škále případů.

Návody, které se zabývají jednoduchou koncepcí,
jež lze snadno nalézt v jiných aplikacích,

nebo návody se zaměřením na vytváření
obsahu, nejsou pro Utopian vhodné.

Utopian poskytuje kromě obecných a pro kategorii
specifických pokynů i šablonu pro video návody,

která vás povede při
formátování vašeho příspěvku.

Podívejme se na ni blíže.

Jak jste viděli v pokynech,

je důležité, abyste spojili svůj návod
s příslušným repozitářem na Githubu.

V této části příspěvku
uveďte jednotlivé pojmy,

kterými se budete
v návodu zabývat.

Tyto pojmy musejí být podstatné

a nesmějí obsahovat věci, které
může běžný uživatel zjistit sám.

Přestože je důležité popsat
v návodu více pojmů,

věnování pozornosti příliš mnoha konceptům
může být pro čtenáře zatěžující.

Jestliže máte více oblastí, kterým
se chcete v návodu věnovat,

zvažte vytvoření několika návodů, abyste
pokryli obsáhli veškeré informace.

V této části musíte vyjmenovat
softwarové a hardwarové požadavky,

aby čtenář mohl návod sledovat.

Uveďte úroveň dovedností a znalostí, které
čtenář musí mít, aby mohl návod dokončit.

Zde uvedete detailní doplňující text
a obrázky pro svůj video návod.

Věnujte pozornost všem
podastatným pojmům

a uveďte další informace,
které povedou vaše čtenáře.

Utopian podporuje tvorbu
sérií podrobných návodů,

které se zabývají aspekty
projektů s otevřeným zdrojem.

Všechny kódy a doplňující materiály můžete
nahrát do svého repozitáře na Githubu.

Existují dvě
podkategorie návodů:

programátorské návody a návody
pro koncového uživatele.

Programovací příspěvky musejí obsahovat
jasné postupné kroky k daným konceptům.

Jakmile uvedete nové
koncepty a metody,

musíte jasně vysvětlit,
jak a proč je používáte.

Psaní kódu může být složité, proto byste
měli být důkladní a postupovat popořadě.

Návody zaměřené na koncového uživatele
jsou určeny pro komplexní funkce aplikací.

Stejně jako u programovacích návodů, i zde
musíte postupovat popořadě a být důkladní.

Při výběru tématu svého
návodu se musíte ujistit,

že váš návod je
prospěšný pro komunitu.

Vyhledejte existující materiály
spojené s vybraným tématem

a vyhněte se publikaci obsahu, který
je už dostatečně popsaný někde jinde.

Vybírejte témata, o kterých máte
dost znalostí a která vás zajímají.

Pamatujte na čtenáře a upravte
obsah pro jejich potřebu.

Jakmile máte vybrané
téma pro svůj návod,

je na čase vytvořit příspěvek s vaším
oblíbeným rozhraním pro Steem.

Jako první zvolte
vhodný název příspěvku.

S využitím šablony
sepište jeho obsah.

Ujistěte se, že jste zahrnuli veškeré
informace naznačené v šabloně.

Zadávání správných štítků
je velice důležité.

První štítek musí být utopian-io a
druhý štítek musí být tutorials.

Před publikací příspěvku vše zkontrolujte,
abyste odstranili zbývající chyby.

Jakmile jste spokojení se svým
příspěvkem, publikujte ho.

Vzdělání je jádrem
open source komunity.

Vaše návody pomohou zájemcům
používat a rozvíjet nové aplikace

a posílit tak
komunitu kolem nás.