On Sun, 8 Jun 2025 at 04:54, Herve Boutemy <hbout...@apache.org> wrote: > > there is a question of nice communication/marketing vs strict accuracy > and always this "project" term that is unclear (as in > https://www.apache.org/#projects-list ) > > in index page: > - 2 top graphs being about committees are accurate, or there is a bug to be > fixed > - 2 bottom graphs are more based on projects declarations, then known > incomplete = where we need to drive interest for improvement
The index page says: "This site is a catalog of Apache Software Foundation projects" That is not true; at best it is misleading, as it is only a partial catalog. I don't think we should be misrepresenting the content of the site; doing so does not seem nice/polite to me. > On the bottom graphs, reading "click on a language to view all projects using > it" is definitively misleading: I'll replace with "click on a language to > view declared projects using it" > > perhaps there are other improvement ideas, less aggressive to casual user > than copying message from https://projects.apache.org/projects.html to > index.html top area It does not have to be the exact same message, but the main page must not misrepresent the content of the site. > On 2025/06/05 09:57:35 sebb wrote: > > On Thu, 5 Jun 2025 at 06:19, Herve Boutemy <hbout...@apache.org> wrote: > > > > > > I fully agree on the lack of completeness for projects > > > => I'm convinced about the disclaimer at the beginning of > > > https://projects.apache.org/projects.html > > > no objection at all on it > > > > > > On PMCs = Committees, I don't get why you say the list may not be > > > comprehensive: of course, there may be bugs, but the list of committees > > > is not really done by projects, and even less by DOAP files > > > Am I wrong, or are you aware of serious issue in our completeness of > > > Committees? > > > > See https://lists.apache.org/thread/pxbrn5j6h1jrx8y0wwjxbqk8chmqflf2 > > > > The code currently relies on someone creating the PMC RDF files manually. > > This could probably be automated, and missing entries are reported to > > the site-dev!a.o list: > > > > https://lists.apache.org/thread/449g3ftkrzk4332qktlcqspyrt9ry4kx > > > > > > > > The strong before difference of responsibility, accuracy and completeness > > > of data between Committees and Projects is a key reason why I want to > > > clarify that DOAP is key for Projects, but not for Committees > > > > Indeed, but the index page no longer makes it clear that project data > > may be incomplete. > > > > "" > > > > > (very useful discussion) > > > > > > Regards, > > > > > > Hervé > > > > > > On 2025/06/04 23:42:23 sebb wrote: > > > > On Thu, 5 Jun 2025 at 00:15, Herve Boutemy <hbout...@apache.org> wrote: > > > > > > > > > > I'd love to have a PR for better discussion... > > > > > > > > > > I'll revert if you really feel strong about it > > > > > but have this copy/pasted in 2 places is IMHO not the most efficient > > > > > to help end users understand committees (foundation data) vs projects > > > > > (DOAP) > > > > > > > > > > I just added links behind these 2 terms on the main page to foster > > > > > focus: > > > > > https://projects.apache.org/ > > > > > > > > > > Please confirm if this is ok or if you really want to revert this > > > > > commit: I'm not convinced, but I'll add back the copy/paste if you > > > > > really want > > > > > > > > As it stands, the page reads as though the site contains a > > > > comprehensive list of all PMCs and projects. > > > > But that is far from being the case. > > > > > > > > I think it is vital that the main page of the site is very clear that > > > > it depends on projects providing the information, and that it is > > > > optional. > > > > Not only may information be missing, but it may also be out of date. > > > > > > > > It may be reworded, but a clear disclaimer needs to be shown so > > > > readers are aware. > > > > > > > > > Regards, > > > > > > > > > > Hervé > > > > > > > > > > On 2025/06/04 08:57:05 sebb wrote: > > > > > > On Tue, 3 Jun 2025 at 22:59, <hbout...@apache.org> wrote: > > > > > > > > > > > > > > Author: hboutemy > > > > > > > Date: Tue Jun 3 21:59:29 2025 > > > > > > > New Revision: 1926099 > > > > > > > > > > > > > > URL: http://svn.apache.org/viewvc?rev=1926099&view=rev > > > > > > > Log: > > > > > > > use no-tlp-doap category to find TLPs with no DOAP > > > > > > > > > > > > > > Modified: > > > > > > > comdev/projects.apache.org/trunk/site/about.html > > > > > > > comdev/projects.apache.org/trunk/site/index.html > > > > > > > comdev/projects.apache.org/trunk/site/projects.html > > > > > > > > > > > > > > > > > > > <snip> > > > > > > > > > > > > > Modified: comdev/projects.apache.org/trunk/site/index.html > > > > > > > URL: > > > > > > > http://svn.apache.org/viewvc/comdev/projects.apache.org/trunk/site/index.html?rev=1926099&r1=1926098&r2=1926099&view=diff > > > > > > > ============================================================================== > > > > > > > --- comdev/projects.apache.org/trunk/site/index.html (original) > > > > > > > +++ comdev/projects.apache.org/trunk/site/index.html Tue Jun 3 > > > > > > > 21:59:29 2025 > > > > > > > @@ -29,9 +29,6 @@ > > > > > > > </div> > > > > > > > > > > > > > > <div id="contents"> > > > > > > > - <p>Please note that the information displayed <a > > > > > > > href="projects.html">here</a> relies on the DOAP files which <a > > > > > > > href="committees.html">PMCs</a> are encouraged to provide. > > > > > > > - However DOAPs are not mandatory, and not all PMCs have > > > > > > > provided a DOAP for all the projects they manage. > > > > > > > - </p> > > > > > > > > > > > > -1 > > > > > > > > > > > > I think that information needs to be retained on the main page. > > > > > > > > > > > > > <h2>Welcome to the Apache Projects Directory</h2> > > > > > > > <p>This site is a catalog of Apache Software Foundation > > > > > > > projects. > > > > > > > It is designed to help you find specific projects that > > > > > > > meet your interests and to gain a broader understanding of > > > > > > > > > > > > > > > > > > > <snip> > > > > > > > > > > > > --------------------------------------------------------------------- > > > > > > To unsubscribe, e-mail: dev-unsubscr...@community.apache.org > > > > > > For additional commands, e-mail: dev-h...@community.apache.org > > > > > > > > > > > > > > > > > > > > > > --------------------------------------------------------------------- > > > > > To unsubscribe, e-mail: dev-unsubscr...@community.apache.org > > > > > For additional commands, e-mail: dev-h...@community.apache.org > > > > > > > > > > > > > --------------------------------------------------------------------- > > > > To unsubscribe, e-mail: dev-unsubscr...@community.apache.org > > > > For additional commands, e-mail: dev-h...@community.apache.org > > > > > > > > > > > > > > --------------------------------------------------------------------- > > > To unsubscribe, e-mail: dev-unsubscr...@community.apache.org > > > For additional commands, e-mail: dev-h...@community.apache.org > > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: dev-unsubscr...@community.apache.org > > For additional commands, e-mail: dev-h...@community.apache.org > > > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@community.apache.org > For additional commands, e-mail: dev-h...@community.apache.org > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org