Hacker News new | ask | show | jobs
by cxr 2136 days ago
It sure would be nice if there were an off-GitHub way to help you guys with your docs. Before this new revamp, I spotted a link whose redirect had disappeared. I resorted to emailing someone on staff, and they filed an issue about it, but it was an experience that's pretty far removed from the efficiency of a wiki.
1 comments
kentonv 2136 days ago
The docs are on GitHub:

https://github.com/cloudflare/workers-docs-engine

By "off-GitHub" do you mean you'd prefer there were some other way to edit the docs directly? Mind if I ask why?

link
cxr 2136 days ago
The repo is linked all over the docs. It what I used to track down the problem.

> By "off-GitHub" do you mean you'd prefer there were some other way to edit the docs directly?

Yup.

link
kentonv 2136 days ago
OK, but, what's the problem with GitHub? I want to understand. Like, is this a political thing, or is this a usability thing?
link
kentonv 2136 days ago
Not sure why your reply was deleted, but FWIW...

> https://www.colbyrussell.com/2020/05/13/psa-wikis.html

Forking a github repository to edit one file and submit it back as a PR is super-duper easy these days. You can do it entirely from the UI by just clicking the pencil icon when viewing the file you want to edit.

I'd argue the only real difference from a classic Wiki is that you need to submit the change for review. There's really no practical way we could eliminate the need for review.

link