dweiss commented on issue #11870: URL: https://github.com/apache/lucene/issues/11870#issuecomment-1372325036
What I meant is that this documentation should really go into modules/ classes where it belongs and can be updated/ maintained together with the code. I honestly don't believe the effort to write a separate manual will be kept in sync with the code. I am with you on many libraries having excellent documentation - it'd be great to have it. The truth is, it's a huge effort not many people will have time for (or the interest in doing, compared to writing new features or tinkering with the code). Sorry to sound so pessimistic - you're welcome to do anything you like, of course - that's the beauty of open source. Also, perhaps chatgpt can emit this automatically in a few months if you point it at the source code?... :) -- 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 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
