jebnix commented on issue #11870:
URL: https://github.com/apache/lucene/issues/11870#issuecomment-1386297416

   @uschindler That's nice, but I personally miss two things about the Lucene 
repo:
   1. The ability to find the documentation in a central place (that makes the 
contribution much easier). That's the way most repositories manage project 
documentation. The Javadoc in my opinion is good for code-related notes, and 
separate docs (that are currently inside `package-info.java`) - inside a 
`docs/` dir.
   2. Some generated **good-looking** documentation site. I suggest Docusaurus 
usage, so the docs will get written in MD, and look like [this for 
example](https://redux.js.org/).


-- 
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

Reply via email to