4 ms·
> This means that changing it means changing the compiler, Wow. What a terrible decision. I'm quite surprised that people actually agreed to that. I originall
by jnordwick 7y ago
> This means that changing it means changing the compiler,
Wow. What a terrible decision. I'm quite surprised that people actually agreed to that.
I originally said it was shit but I toned it down a little. The information isn't bad, just too difficult to find if you don't already know exactly what you are looking for. You work on rust core so I don't think you are the best person to judge.
The good part is this can mostly be solved by better formatting and adding a top one-one summary section that groups similar functions and traits (creation, mutation, lookup, etc). With just that you could even convince me to ignore the terrible formatting in the lower section.
The general take away is that the docs are too difficult to scan and if you don't already know something exists and its name, the docs aren't very useful.
- steveklabnik 7y ago> Wow. What a terrible decision. I'm quite surprised that people actually agreed to that. It's not really possible in any other way. Building API docs is a compilation process, from source code to HTML. You either use the compiler, or re-implement parts of it. The latter makes for interesting bug possibilities.