- 🇺🇸United States scottatdrake
I started looking at this issue at #drupalconPortland2024. My understanding of the blocker here is that adding comments for 1,300+ classes in the format "Class [class name]" is not valuable, and there are too many to write manually. In fact, I think there may be a PHPStan rule prohibiting repeating the class name in the comment, though I'd need to verify that claim.
A couple of years have passed since this ticket was last updated. Now, we have LLM's like ChatGPT which can be pretty good at summarizing code. My idea is to write a script of some sort that passes the work of writing a meaningful description to one of them.
Reviewing such a large MR will still be a challenge but we may be able to automate the writing portion.
I'll wait for feedback before pursing this approach further.
- 🇳🇿New Zealand quietone
There are too many changes here and they will require some thought to decide on a correct summary line, so making this a meta.