Call it INSTALLATION, and simply highlight what is necessary to get OFBiz running: Have jdk, version 8 invoke the gradle-init script
I concur with Michael, people who don't read the readme.adoc will possibly forgo the other readme too. Met vriendelijke groet, Pierre Smits *Proud* *contributor** of* Apache OFBiz <https://ofbiz.apache.org/> since 2008 (without privileges) *Apache Trafodion <https://trafodion.apache.org>, Vice President* *Apache Directory <https://directory.apache.org>, PMC Member* Apache Incubator <https://incubator.apache.org>, committer Apache Steve <https://steve.apache.org>, committer On Sun, May 10, 2020 at 7:29 PM Michael Brohl <michael.br...@ecomify.de> wrote: > Hi Jacques, > > do you think that people who do not read README.adoc would rather read a > README.txt file? > > I doubt that you'll reach those people with that file but it might be > worth a try. I would name the file README without extension to better > match LICENSE, NOTICE, VERSION etc.. > > Thanks, > > Michael Brohl > > ecomify GmbH - www.ecomify.de > > > Am 10.05.20 um 18:43 schrieb Jacques Le Roux: > > Hi, > > > > We often get questions from people not reading the basic > > documentation. Like not able to run Gradle because ignoring > > init-gradle-wrapper scripts. > > > > I know there will always people not reading the documentation. But > > maybe, to prevent most obvious questions and tempting RTFM answers, we > > could add a small README.TXT with basic information in OFBiz root. > > > > It would ultimately refer to README.adoc. Also saying that README.adoc > > can be read with a text reader tool. And it's easy to follow > > > https://asciidoctor.org/docs/convert-documents/#converting-a-document-to-html > > > > What do you think? > > > > Jacques > > > >