[eastdakota]

Here’s a blog post on the process and rationale: https://blog.cloudflare.com/new-and-improved-workers-docs/

[cxr]

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.

[kentonv]

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?

[cxr]

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.

[kentonv]

OK, but, what's the problem with GitHub? I want to understand. Like, is this a political thing, or is this a usability thing?

[kentonv]

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.