Much like Alice, I also had a CL reverted a while ago, for the same reason. I dug around in logs and eventually figured out the magical incantation"content_shell -- --run-layout-test --enable-leak-detection." Unlike Alice, I complained to myself for a bit that there's no guidance on this process, and then I forgot all about it and moved on to the next thing. Thank you for spending the energy to get us talking about this issue!
Here's what I propose, based on what I thought about. I tried to aim for a maximally lightweight process that will eventually get us in a position to do interesting stuff.
1) Create a google group, e.g. reverted-cls@chromium. (a bug label is a worthy contender, see "expected benefits" later on)
2) Whenever a CL gets reverted, for any reason, the person (or bot) reverting posts a message to reverted-cls@ including the CL link, the failing bot (if applicable), and the relevant output.
3) (Optional) while debugging, the author can post messages documenting things that helped and things that didn't. This can include commands and URLs for docs / other bots.
4) When the author figures out the issue and relands the CL, the author posts a message describing the "golden path" of what worked.
Here are the benefits I'm looking to get out of this:
1) When my CL gets reverted, I implicitly learn about the mailing list. I can do searches and learn from others' experience.
Note 1: The wisdom is probably spread out on blink-dev@ or other lists. A designated mailing list would pool all this together, and is lighter-weight than having people maintain docs with best practices.
Note 2: I'm sure asking would get me the information I need, but I'm too much of an introvert to ask blink-dev@ to solve all my problems :)
2) Ops can monitor the list for patterns and use the data to improve the trybots and CQ.
3) Once there's enough data collected on the list, we can start playing with building models for auto-suggestions. We'd set up a couple of templates for the mailing list messages, to help parse the messages.
While benefit 3) is the biggest reason for the mailing list, I claim that it'd create enough value to offset the cost of posting very soon after it is launched.
Thank you for reading. I look forward to your thoughts!
Victor