‹ BackHN Continuity

Thread

The GitHub wiki is an anti-pattern (2022)

175 points · 112 comments · ibobev

  1. codazoda · · focus · HN ↗
    I'm no fan of GitHub add-ons and I agree with the premise here but...

    I can think of one other possibility. It's easier to write in a wiki via the browser. I can open that on my phone and edit docs. I can open it in my browser and edit docs.

    On desktop it's a tiny bit more to pull the repo and open it in your editor (and you might already be there) but that tiny bit can be enough to stop you from writing documentation. For me, writing documentation must be totally painless so that I'll actually do it.

    Why am I not a fan of the add-ons like PR's, wiki's, discussions, projects, and issues? Because they each introduce vendor lock-in to varying degrees.

    1. cocoto · · focus · HN ↗
      You can edit single files in most git forges and it will open a pull request for you, the workflow is not that bad.
Open on Hacker News to reply ↗

Unofficial Hacker News client; not affiliated with Y Combinator.