Hacktoberfest 2026：維護者為十月標記出來的 issue，仍然開放、適合新手。 瀏覽 Hacktoberfest issue

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

未關閉
  • 哪裡不對？
#17 5 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度
5/5
預估耗時
一週以上
新手友好度
25/100
Issue 類型
功能
描述清晰度
需要釐清
活躍度
停滯
技術堆疊
git, github, markdown
領域
developer-experience, documentation

研究方向

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.

由索引模型根據 Issue 內容生成。

描述

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.

主要語言
CSS
星號
11
分支
25
30 天內沒有已合併 PR

環境準備

這個專案沒有提供開發容器、Dockerfile 或貢獻指南，環境需要你自己搭建：先看它的 README，通用步驟見我們的新手貢獻指南。

從這裡開始

  1. 先讀完整個 Issue，再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫，在一個分支上完成修改。
  4. 送出 Pull Request，並在描述裡引用這個 Issue 編號。

pyvec/blog.python.cz 的其他 Issue

查看 pyvec/blog.python.cz 的全部 Issue

相似的 Issue

更多 DevTools Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。