Reflections on using Go instead of D

[Paulo Pinto]

On Wednesday, 13 July 2022 at 08:21:53 UTC, Ola Fosheim Grøstad 
wrote:
> On Wednesday, 13 July 2022 at 07:56:14 UTC, jfondren wrote:
>> [...]
>
> I don’t use Rust, but autogenerated tend to lead to poor 
> structure, too long documents (or too small). I don’t want 
> bloat, I want just the right info at the right time with the 
> ability to request more details when needed without 
> scrolling... Good documentation is difficult to create,  but 
> worth it as standard libs dont change much.
>
>> [...]
>
> Ok, looks bloated on this iphone, but I haven’t used it so it 
> might be ok in real use.
>
> It provides examples, which is good, but I don’t want examples 
> unless I request it... I want documentation that expands on the 
> topic on my request.
>
> I understand that this cannot be done for regular libs, but I 
> think one can raise the bar for std libs.

Rustdoc examples also work as unit tests, which means they are 
always in sync with the code

https://doc.rust-lang.org/rustdoc/write-documentation/documentation-tests.html