jainankitk opened a new issue, #15225: URL: https://github.com/apache/lucene/issues/15225
### Description ### Background ### With the recent release of 10.3, java documentation for [geoutils package](https://lucene.apache.org/core/10_3_0/core/org/apache/lucene/geo/package-summary.html) and other classes within the package significantly clearer and more comprehensive compared to [10.2 release](https://lucene.apache.org/core/10_2_0/core/org/apache/lucene/geo/package-summary.html). This improvement was created with the help of an LLM, requiring relatively little effort but yielding much higher-quality documentation. This suggests an opportunity to improve **other Lucene packages** in the same way. With LLMs, contributors (including newcomers) can quickly draft stronger package-level docs, which reviewers can then refine. ### Proposal ### Encourage contributors to use LLMs to draft or refine JavaDocs for under-documented packages. The workflow would be: 1. Identify a package with minimal or outdated JavaDocs. 2. Use LLM assistance to generate a clearer package summary (overview, key concepts, common operations, examples). 3. Submit as a documentation PR following engagement guidelines. ### Engagement Guidelines for Contributors ### * **Scope your PRs:** * For substantial improvements, limit changes to ~10–15 files or a logical section (e.g., one package) per PR. * For minor fixes (typos, formatting), larger file counts are acceptable. * **Review before submit:** Always read through the LLM-generated docs and adjust wording for accuracy and tone. * **Tag this issue:** Reference this umbrella issue in your PR description (e.g., “Related to #XXXX”). * **Allow review time:** Reviewers are effectively vetting technical documentation, so please be patient with feedback. ### Benefits ### * Raises quality of Lucene documentation across the board. * Lower barrier to contribution (great entry point for new contributors). * Scales documentation improvements with minimal effort while keeping reviews manageable. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
