4 ms·
Here’s a blog post on the process and rationale: https://blog.cloudflare.com/new-and-improved-workers-docs/ https://blog.cloudflare.com/new-and-improved-workers
by eastdakota 6y ago
Here’s a blog post on the process and rationale: https://blog.cloudflare.com/new-and-improved-workers-docs/ https://blog.cloudflare.com/new-and-improved-workers-docs/
- cxr 6y agoIt 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 6y agoThe docs are on GitHub: https://github.com/cloudflare/workers-docs-engine 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 6y agoThe 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 6y agoOK, but, what's the problem with GitHub? I want to understand. Like, is this a political thing, or is this a usability thing?
- deleted 6y ago[deleted]
- kentonv 6y agoNot sure why your reply was deleted, but FWIW... > https://www.colbyrussell.com/2020/05/13/psa-wikis.html 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.