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

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

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

Reply via email to