Created attachment 102677 [details] [review] Bug 25104: Small adjustments to NewVersion Main point: all descriptions go under the line with version/bugno. Simplify the code in NewVersion. Test plan: Run updatedatabase on command line as well as interface. Signed-off-by: Marcel de Rooy <m.de.rooy@rijksmuseum.nl>
The idea was to keep 1 line per entry, so I do not think we should split them into 2. Also I liked the idea of not having to pass an arrayref when we have only 1 line (90% of the time).
I agree with Jonathan here, keeping comments on one line where we can is a feature rather than a bug.. The code may be a little messy, but it's also clear what it does. What I would like to see at some point is more of a guideline for how to best use the multi-line descriptions.. I think in general we should lead with a short summary and following lines should be for either deeper descriptions or warnings..