Devon Carew

> Design is always tricky. We used to have something like this, then got feedback, #3171, that each item should be exactly 1 line tall, with good reasons. 🤷 Ah,...

I think it would be worth looking at leveraging dart_style here - to feed the code fragments through dart_style and use that to manage the line-wrapping.

I have implemented a system like this for another tool - using dart_style to render element descriptions. The main simplifying assumption I found was that dart_style only changes the amount...

Yeah, I think this would be great - it would give more context to the categories. We can manually describe things in the markdown above the generated list, but messaging...

FYI, this PR: https://github.com/dart-lang/dartdoc/pull/3018 Removes the sidebar for all elements which do not themselves contain members. So, it retains it for things like libraries, classes, and extensions, but removes it...

It looks like the flutter bot is failing due to the fact that we no longer support a `no-validate-links` cli flag. I think we should just remove the use of...

Ah, I assume from the error that flutter is sending in the `--no-validate-links` flag? I'll find the reference.

@brianquinlan - should we think about re-implementing the web client in terms of the https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API API? (see also https://github.com/dart-lang/http/issues/595)

@PoloLacoste - thanks for the PR here! I agree this part of `mandatory` options was a bit of a UX cliff - it stopped `-h` help working for commands that...

https://github.com/dart-lang/code_builder/pull/389 implements a little bit of this - the ability to have line comments for libraries, emitted at the beginning of the file (`// Generated by ...`).