News for hackers. Stuff that matters.
Re:Apple's DocC is excellent, but unusable for open source p... by noctune on Wednesday June 30, 2021 @06:20AM (#27686846)
IMO, search is a pretty significant part of docs and I haven't seen a good way doing that without either javascript or a web server.

But other than that, yeah, you don't really need JS.

Re:Apple's DocC is excellent, but unusable for open source p... by est31 on Wednesday June 30, 2021 @06:27AM (#27686894)
Rust's documentation uses javascript for search but it uses no js framework at all. IIRC the normal experience works without any JS. In fact it doesn't even use any traditional js tooling, allowing people to contribute to rustdoc without having to install npm.
Re:Apple's DocC is excellent, but unusable for open source p... by GrayShade on Wednesday June 30, 2021 @06:36AM (#27686949)
> allowing people to contribute to rustdoc without having to install npm

In the meanwhile, the crates.io team doubled down on Ember to attract front-end developers while presumably alienating a lot of other potential contributors.

Re:Apple's DocC is excellent, but unusable for open source p... by Zababa on Wednesday June 30, 2021 @02:22PM (#27691868)
The crates.io website is weird, it seems out of place and not at the same level as the other part of Rust's ecosystem.
Re:Apple's DocC is excellent, but unusable for open source p... by jitl on Wednesday June 30, 2021 @08:44AM (#27687779)
Recall that cargo and crates was built by one of the Ember founders, Yehuda Catz.
Re:Apple's DocC is excellent, but unusable for open source p... by GrayShade on Wednesday June 30, 2021 @09:13AM (#27688059)
Were they? I don't see wycats among the crates.io contributors on GitHub. He did contribute a bit to cargo in 2015, though.
Re:Apple's DocC is excellent, but unusable for open source p... by gumby on Wednesday June 30, 2021 @12:00PM (#27690113)
You can just pass the query to an external search engine , adding a `site:xxx` restriction.
Re:Apple's DocC is excellent, but unusable for open source p... by IshKebab on Wednesday June 30, 2021 @06:01PM (#27693912)
Every time a site has done that I immediately go back because the experience sucks so much.
Re:Apple's DocC is excellent, but unusable for open source p... by gumby on Wednesday June 30, 2021 @06:37PM (#27694317)
Better than most site search engines, which I admittedly a pretty low bar.