In particular:

• https://github.com/hibernate/hibernate-search#description should be rewritten to take into account the fact that Apache Lucene is no longer a mandatory dependency. In particular queries cannot always be "'native' Apache Lucene queries" anymore when using the Elasticsearch backend.
• https://github.com/hibernate/hibernate-search#source-code-structure is out of date
• the "getting started" guide we link to in https://github.com/hibernate/hibernate-search#getting-started refers to Search 5 guides

And there may be more. Let's review the file and do whatever we'll deem necessary.