3 ms·
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.
by cxr 6y 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.
- 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.