undefined | Better HN

0 pointskentonv5y ago0 comments

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?

0 comments

cxr5y 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.

kentonvOP5y 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?

kentonvOP5y 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.

j / k navigate · click thread line to collapse

0 pointskentonv5y ago0 comments

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?

0 comments

cxr5y 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.

kentonvOP5y 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?

kentonvOP5y ago

Not sure why your reply was deleted, but FWIW...

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

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.

j / k navigate · click thread line to collapse