jebnix opened a new issue, #11870: URL: https://github.com/apache/lucene/issues/11870
### Description I think it would be much easier to read and maintain markdown-based documentation, instead of/in addition to the Javadoc one. This way we would be able to generate sites from it. This is a pretty big suggestion and change to Apache Lucene, but I think it'll be worth it. The initial idea is to unify all of the main Javadoc package summaries to one folder in which each Javadoc package summary (e.g. https://lucene.apache.org/core/9_4_0/core/org/apache/lucene/search/package-summary.html#package.description) is a markdown page. -- 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: issues-unsubscr...@lucene.apache.org.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org For additional commands, e-mail: issues-h...@lucene.apache.org