Christofer Dutz wrote on 6/30/23 6:29 AM:
Well continuing would mean that we file the incubator reports on time.
If we do that, I’m fine with continuing. If we don’t, well … guess then it’s
time to retire.
Thinking forward to ASF project (i.e. after graduation) expectations,
the board needs to see three PMC members who can be active enough to
make reports and respond to security issues. So it sounds like you're
fine to continue now, as long as Incubator reports get in.
...
Von: Mirko Kämpf <[email protected]>
...
*The Apache Training project uses automated data analysis to check (some
of) the criteria mentioned above.*Using the source code repository as a
starting point we will investigate the documentation corpus and make it
accessible for
a chat based interaction => Apply ChatGPT to the repo for contextual search.
We can generate a report from the repository which will be "reported to" or
"exposed via" Apache Training project. => We have to define in which form.
First proposal: generated ADOC files in the github repository would be fine
for an inventory.
Interesting - so you're saying part of the code Training would produce
is repo analysis of "what documentation/useful human content" does each
ASF project have, and how can we quantify "how useful" some doc is?
That could be useful, even if it's slightly different than the concept
of "providing easy tools to make training courses".
A few comments on this:
- There are no ASF policies on specific documentation, so anything you
suggest would be a best practice, not a requirement for other projects.
- There are several non-ASF projects that are doing interesting work in
the auto-discovery and analytics of codebases, it might be worth seeing
some of their techniques (or maybe their code) in terms of how they
crawl repos and the like:
https://chaoss.community/
https://chaoss.github.io/grimoirelab/
https://bitergia.com/
While they focus on higher level analytics, I bet (eventually, someday)
they'd also be interested in scanners for README quality and formatting
and the like.
Personally, my time is limited thru October, but I hope to have more
volunteer time after that. I hope the podling stays around, the concept
of making coder-friendly ways to easily re-use training content is
important for the whole ecosystem.
--
- Shane
Member
The Apache Software Foundation
