Popsat a ošetřit všechny možné způsoby použití

Review the existing simple and complex article-contribution guides and the blog publish workflow, focusing on fork, branch, GitHub, and pull request paths. Compare the documented alternatives, including the possible Medium migration, and clarify which approach the project will adopt. Done means the contribution workflow is decided and the relevant guides or scoped tool changes are defined.

Blog má spoustu nejasností a problémů:

• Původní myšlenka byla, že většina článků bude jen text. To se nepotvrdilo, prakticky každý článek má fotky. "Jednoduchý" návod na přidání článku nikdo nepoužívá, protože neumožňuje přidat fotky. Odkaz na složitější návod nejde moc dobře vidět.
• Složitější návod nepočítá s tím, že člověk není Pyvec contributor a že má fork.
• Když udělám branch, blog publish pošle všechno do branche. Když jsem na master, pošle to do masteru. Člověk, který má přístup do masteru, ale chce poslat PR, se snadno splete. Nikde není napsáno, že si má někdo někde dělat branch.
• Když nemám přístup do repozitáře, musím udělat fork a pak poslat příspěvek z něj. Tam by už měl blog publish detekovat, že chci udělat PR, ale opět můžu buď posílat z master forku nebo z větve a nikde to není popsané. Pokud chci napsat v budoucnu další článek, musím udělat buď sync s upstream, nebo smazat fork a začít znova.
• Je těžké vyvážit návody podle toho, jestli někdo umí git, neumí git, atd. Někdo článek naklikává přes GitHub a to dělá zase úplně jiné věci.
• Není úplně jasné jak něco opravit ve vytvořeném PR, když někdo něco okomentuje. Záleží to dost na tom, jestli to člověk poslal z forku, masteru, naklikal to přes GitHub, ... zase je 20 možností.

Možná je toho víc, snažil jsem se sepsat hlavně zádrhely, na které jsem narazil já, @lspdv a @zuzejk.

Celkově jsou návody nedostatečné. Otázka je, jestli chceme spíš

1. psát návody na všechny možné varianty jak do tohoto blogu přispět z gitu a navíc z GitHubu, pro začátečníky i pokročilé,
2. nějak tuto komplexitu zapouzdřit do blog publish a podchytit v tom příkazu všechny možné varianty jak do tohoto blogu přispět z gitu a navíc z GitHubu, pro začátečníky i pokročilé,
3. nebo se vykašlat na blog v podobě git repozitáře a dát to někam na medium.com či jinam.

První dvě varianty:

➖ Blog musí někdo vyvíjet, opravovat, vylepšovat, dodělávat návody. Já nemusím mít vždycky čas.
➕ Blog učí začátečníky pracovat s GitHubem, Gitem, Markdownem, reviews, apod., což jsou dost zásadní znalosti. Není to úplně škola hrou, ale pořád je to podle mě užitečný.
➕ Na blogu lze dělat PR, které fungují dobře na review před vydáním a to review nemusí dělat jeden nějak pověřený člověk, ale kdokoliv. Blog funguje transparentně, komunitně, kdokoliv může poslat PR a kdokoliv se k němu může vyjádřit. Kdokoliv může poslat další PR třeba s opravou překlepu.

Třetí varianta:

➕ Nikdo se nemusí starat o provoz blogu, ten prostě funguje a lidi na něj píšou. Není potřeba nic programovat, provozovat, psát návody a mít na to čas.
➖ Nevím, jak funguje přesně Medium, jestli tam jde nějak mít víc autorů, dělat review článku, apod. a přitom to mít nějak relativně zadarmo.