Sorry I didn't catch up on the other thread "gpg gradle warnings" discussing docs which makes my reply somewhat redundant. I do think it's important that the README remains where it is and keeps housing the vital information it currently does. I do agree that it should also be part of the ASCII doc too but can we have the README be incorporated into that ASCII doc without having to maintain both separately and have the risk of the versions being out of sync.
Ed On Tue, Jun 13, 2023 at 11:30 PM Ed Cable <edca...@mifos.org> wrote: > Rob, I think where you've been at (especially the README) is still the > best places for getting started instructions on your build and dev > environment. Another area of recently maintained technical documentation > around Fineract is the ASCII doc that gets maintained/updated with each > release: https://fineract.apache.org/docs/current > > Ed > > On Tue, Jun 13, 2023 at 5:00 PM Petri Tuomola <pe...@tuomola.org.invalid> > wrote: > >> Hi Rob - can you share the build log/failures so we can see where this is >> breaking? >> >> Thanks >> >> Regards >> Petri >> >> On Wed, 14 Jun 2023 at 07:14, Rob Tompkins <chtom...@gmail.com> wrote: >> >>> Hello, >>> >>> I have struggled to get the project to build and to figure out where to >>> get a local developent environment started. I’ve started in the standard >>> location one would start [1]. From there, I’m quickly pointed to [2]. From >>> here I get the impression that I’m to run a local instance of MariaDB, and >>> then run the gradle commands: >>> >>> ./gradlew createDB -PdbName=fineract_tenants >>> ./gradlew createDB -PdbName=fineract_default >>> ./gradlew bootRun >>> >>> however these seem to result in build failures. I’m using java-17 >>> locally on my mac (the amazon corretto model). My gradle --version prints >>> out the following: >>> >>> chtompki@Robs-MacBook-Pro-2 ~ % gradle --version >>> >>> Welcome to Gradle 8.1.1! >>> >>> Here are the highlights of this release: >>> - Stable configuration cache >>> - Experimental Kotlin DSL assignment syntax >>> - Building with Java 20 >>> >>> For more details see https://docs.gradle.org/8.1.1/release-notes.html >>> >>> >>> ------------------------------------------------------------ >>> Gradle 8.1.1 >>> ------------------------------------------------------------ >>> >>> Build time: 2023-04-21 12:31:26 UTC >>> Revision: 1cf537a851c635c364a4214885f8b9798051175b >>> >>> Kotlin: 1.8.10 >>> Groovy: 3.0.15 >>> Ant: Apache Ant(TM) version 1.10.11 compiled on July 10 2021 >>> JVM: 17.0.7 (Amazon.com Inc. 17.0.7+7-LTS) >>> OS: Mac OS X 13.4 aarch64 >>> >>> >>> The difficulty to get started here is a bit frustrating - it’s quite >>> hard to find the ins and outs of the project and get going. I am really >>> hoping to spend a bit of my time polishing this up and the surrounding >>> documentation (where’s that stored? the wiki?). Streamlining this process >>> will allow us to get a larger number of contributors which is a priority, >>> in my opinion. >>> >>> Thoughts, questions, concerns? >>> >>> Cheers, >>> -Rob >>> >>> >>> >>> [1] >>> https://cwiki.apache.org/confluence/display/FINERACT/Getting+Started+Docs >>> [2] https://github.com/apache/fineract/blob/develop/README.md >>> >> > > -- > *Ed Cable* > President/CEO, Mifos Initiative > edca...@mifos.org | Skype: edcable | Mobile: +1.484.477.8649 > > *Collectively Creating a World of 3 Billion Maries | *http://mifos.org > <http://facebook.com/mifos> <http://www.twitter.com/mifos> > > -- *Ed Cable* President/CEO, Mifos Initiative edca...@mifos.org | Skype: edcable | Mobile: +1.484.477.8649 *Collectively Creating a World of 3 Billion Maries | *http://mifos.org <http://facebook.com/mifos> <http://www.twitter.com/mifos>
