A small UX/navigation improvement proposal after you posted those links Justin (and sharing my learning from writing such docs/mails):
Maybe a good idea to expand the "Related Resources" a bit to add a few more of those links (few of them are there, few could be also) but also to add a little explanation what can be found there "related" to the neutrality page. And this pattern could be repeated on other pages, if those pages follow similar "Related Resources" pattern. For example: Related Resources - Vendor Neutrality <https://cwiki.apache.org/confluence/display/INCUBATOR/Vendor+Neutrality> - description of Vendor Neutrality definition, history and general properties of what Vendor Neutrality is - Incubator Case Studies <https://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Case+Studies>- several case studies, including a number of cases where Vendor Neutrality principles were breached - .... I think (and I practice that a lot) that the practice of having list of links at the end of mail or page is a good one, but only if it's not (even named) bare list of links, even numbered (like in the email of yours : 1. https://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Case+Studies 2. https://cwiki.apache.org/confluence/display/INCUBATOR/Expanded+Incubator+Case+Studies ... I usually would do it this way in emails (the description made up :) ) : [1] Case studies that are relevant to the neutrality https://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Case+Studies [2] Even more case studies, especially the difficult one: https://cwiki.apache.org/confluence/display/INCUBATOR/Expanded+Incubator+Case+Studies Especially when you have longer messages of pages, when you have such a list of links without additional explanation of what you can find there, this becomes just a "bag of links". And usually you focus on the part of the page you are looking at - so even if those links are described elsewhere in context, without clicking the links you won't really know what's there. Knowing what is relevant to the page you are on, it makes it much easier to decide if I really want to go there or not when I am looking for something. J. On Wed, Nov 19, 2025 at 3:07 AM <[email protected]> wrote: > Hi, > > Also see Common Red Flags [1] > > Justin > > 1. > https://cwiki.apache.org/confluence/display/INCUBATOR/Mentor+Quick+Reference+-+Common+Red+Flags
