Hi Justin, Thanks for this. It is really quite thorough and valuable.
I have one major comment. Slide 12 KEY STEPS IN RELEASING does not discuss one of the most commonly made errors: the announcement and corresponding download page. These items might actually deserve a slide of their own. They probably need to be highlighted on slide 13 COMMON PITFALLS IN RELEASES. Incorrect or incomplete Announcement and Download pages. The announcement needs to be prepared to include a description of the project, the main features in the release, a link to release notes, and most importantly, a link to the download page. The download page must be a separate page (or pages) in the podling's web site. The page must have links to the download artifact via either dlcdn or closer.lua; links to the signature and checksum via downloads.apache.org <http://downloads.apache.org/>, and a link to the KEYS file via downloads.apache.org <http://downloads.apache.org/>. Errors in either the announcement or the download page are excruciatingly common among both projects and podlings, and it's worth a call out to make sure that mentors pay attention to them. Warm regards, Craig > On Sep 8, 2025, at 06:30, Justin Mclean <[email protected]> wrote: > > Hi, > > Thanks for the feedback. > >> In general: the layout, with everything up at the top, suggests that >> something is missing in the body of many slides. >> Why is the 'Back' arrow in grey until you hover over it? Grey sort of >> implies that the control is disabled. > > Not sure why it was done that way, but it’s the default for other > presentations as well. I’d guess it's because you generally move forward > through a presentation, or it might indicate “focus” as the space bar > advances the presentation. > >> Slide >> 1: should have the title of the presentation. The welcome message does not >> look like a title, > > I’ll fix this later. > >> 3:: "...make ASF unique" should be "...make The ASF unique" . Same issue on >> other slides. "The" is a formal part of the Foundation name, so we use it >> when talking about the Foundation. We do not have to use it when it is an >> adjective, as in "ASF values”. > > Fixed. > >> 7: "Red flags to watch" should be "Red flags to watch for" > > Done. > >> 17: "...Name to Promote Vendor Products" should be "...name to promote >> vendor products" > > Done. > >> 32: "Votes enable consensus" is a debatable statement. Votes can end an >> attempt to achieve consensus between factions that disagree on the best >> thing to do on this issue. > > A vote can be used to confirm or record consensus, and that is more common > than votes used to move forward when people disagree. Note "stress that votes > record consensus” in the speaker notes. I’ve changed it to " Votes can record > consensus”. > >> 41: "Due quarterly..." should be on its own line > > Fixed. > >> 44: what is "Repeated release"? > > Repeated release issues, i.e. a podling keeps making the same mistakes and > not learning from release feedback. > >> 56 'One person doing all work" should be "One person doing all the work" > > Done. > > Kind Regards, > Justin > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > Craig L Russell [email protected]
