You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@fineract.apache.org by James Dailey <ja...@gmail.com> on 2023/07/05 14:56:36 UTC
Re: On Getting Started with Fineract
John
I think we’re all eager to see what you are working on. We have some hands
willing to help. Can you give an update on this?
Rob - can you send an email detailing what you’d hope to see in the
documentation as a new dev coming to the project?
Ed - can you give a perspective on what you already know is not working in
the documentation?
Thanks
On Wed, Jun 14, 2023 at 9:42 AM Rob Tompkins <ch...@gmail.com> wrote:
>
>
> On Jun 14, 2023, at 10:36 AM, Rob Tompkins <ch...@gmail.com> wrote:
>
>
>
>
> On Jun 14, 2023, at 5:06 AM, John Gathogo <jo...@fiter.io> wrote:
>
>
> @ed, I am working on streamlining the documentation. I will have something
> for the community to preview soon.
>
>
> I would love to help in whatever capacity I can here. Either as a guinea
> pig or a contributor. Tell me where to run to help :-)
>
>
> One more note here, just so you folks know that im not just being an
> ass….Im one who is of the philosophy that if I make noise then id better be
> willing to help ;-) and do so at the direction of the elders on the project
>
> Cheers,
> -Rob
>
>
> Cheers,
> -Rob
>
> I am not sure if its possible to incorporate the readme in the ascii doc
> documentation...will check with Aleks.
>
> Thanks
>
> On Wed, Jun 14, 2023 at 9:38 AM Ed Cable <ed...@mifos.org> wrote:
>
>> 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 <ed...@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 <ch...@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
>>> edcable@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
>> edcable@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>
>>
>> --
Sent from Gmail Mobile
Re: On Getting Started with Fineract
Posted by James Dailey <ja...@gmail.com>.
Thanks John!
Great work. This is what I was hoping you would communicate. I want to
start with moving SOME things over and then decide on the next stuff.
Let's start incrementally.
I've added you to Jira. You are now considered a "Contributor".
Please use your powers well. ;)
I'd also like to know if we can adjust the colors and design of the landing
page. Is that in a stylesheet? Let's grab some time to have a call next
week if that works for you.
Thanks,
James Dailey
On Tue, Jul 18, 2023 at 5:10 AM John Gathogo <jo...@fiter.io> wrote:
> Hello James,
>
> This was a simple proof of concept to visually show what the end product
> will look like. The goal is to consolidate documentation into one place and
> make it easier for devs and non devs to add/update content. In my opinion,
> only the PMC reports, meeting notes and COMMS content should remain in the
> Wiki, the rest should be moved to asciidoc.
>
> In the process of moving it to asciidoc, the content will be reviewed for
> accuracy, relevance and datedness, and outdated information should be
> removed.
>
> The landing page will be more appealing and include all the major links,
> this is what we are aiming for https://camel.apache.org/. We'll start
> small and keep improving over time.
>
> Can someone approve my request for JIRA access. Username = ruhiu
>
> Thanks
>
>
>
> On Thu, Jul 13, 2023 at 2:32 AM James Dailey <ja...@gmail.com>
> wrote:
>
>> Hi John
>>
>> I did find your directory structure by clicking on the "EDIT" link -->
>> https://github.com/jogathogo/fineract/edit/1.7.3/fineract-doc/modules/ROOT/pages/index.adoc
>>
>>
>> Please do send a pull request for this so we can see what the diff would
>> be.
>>
>> FAQ
>> I have some questions about the FAQ you are proposing?
>> The existing FAQ is here ==>
>>
>> https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=91554327
>>
>> Those are frequently asked questions - I try to add to it whenever I get
>> another question on the list serv. It changes from time to time.
>>
>> Was your intention to fully edit that to the following?
>> http://34.125.186.48/build/site/modules/1.8/faq.html
>>
>> because I would want to include the questions and answer structure, since
>> its a FAQ.
>>
>> LANDING PAGE
>> The home page at [http://34.125.186.48/build/site/modules/1.8/index.html
>> ] should include pretty much all of the content currently at our LANDING
>> PAGE https://fineract.apache.org <https://fineract.apache.org>
>> including an easy way to get to the releases, github, listserv, jira
>> tickets, and links to the Apache foundation as on the footer.
>>
>> LISTSERV
>> The project relies 100% on the listserv as the primary way for developers
>> to engage. The instructions for subscribing and unsubscribing should be
>> easy to find.
>>
>>
>> Thanks,
>>
>> On Wed, Jul 12, 2023 at 8:31 AM James Dailey <ja...@gmail.com>
>> wrote:
>>
>>> Hi John - Thank you.
>>>
>>> I am excited to see this. And, where is the code or folder structure
>>> behind this? I think this
>>> http://34.125.186.48/build/site/modules/1.8/index.html explains the
>>> concept you have to some extent, in a visual way, but how this is built and
>>> maintained is very important for us.
>>>
>>> I believe we need to take this in small bites so that we can maintain
>>> the key elements on the wiki that are expected to be there. We will also
>>> need to adjust the wiki, there are external links to the wiki which should
>>> be respected. (We cannot simply delete them but must create links to the
>>> new locations). We need it to be something that can be maintained by you,
>>> by me, by anyone coming to the project and can help out.
>>>
>>> I am not sure I see the relationship between this and the current
>>> AsciiDoc setup. How do you conceptualize the two of them working together?
>>> What's the structure of the folders or how are you running the scripts? I
>>> think that may explain.
>>>
>>> Where is the Landing page? This is a requirement. There are "rules and
>>> norms" from Apache that should be followed with regard to that.
>>>
>>> I'll accept the Jira request. Anyone on the PMC can approve your request
>>> to be added to Jira. To be explicit, and I am certain he agrees, Ed is
>>> simply one person on the project.
>>>
>>> Thanks,
>>> James Dailey
>>>
>>>
>>>
>>> On Wed, Jul 12, 2023 at 12:03 AM John Gathogo <jo...@fiter.io> wrote:
>>>
>>>> Use this link http://34.125.186.48/build/site/modules/1.8/index.html
>>>>
>>>> On Wed, Jul 12, 2023 at 9:39 AM John Gathogo <jo...@fiter.io> wrote:
>>>>
>>>>> Hello Everyone,
>>>>>
>>>>> The overall goal of this is to consolidate project documentation into
>>>>> one place to give all stakeholders a great user experience.
>>>>>
>>>>> To do this, I am moving content found in different places like the
>>>>> wiki, readme and others to fineract-doc and converting it to asciidoc. The
>>>>> idea is to have docs sitting in the same place as code for easier
>>>>> maintenance.
>>>>>
>>>>> A preview of this can be see here
>>>>> http://34.125.186.48/build/site/modules/1.8/index.html
>>>>>
>>>>> I should be able to raise a PR for review and contribution by others
>>>>> by early next week.
>>>>>
>>>>> @edcable@mifos.org <ed...@mifos.org> I requested access to Jira,
>>>>> please approve this to allow me create tickets on the fineract jira board.
>>>>>
>>>>> Thanks,
>>>>> Ruhiu
>>>>>
>>>>> On Wed, Jul 5, 2023 at 5:57 PM James Dailey <ja...@gmail.com>
>>>>> wrote:
>>>>>
>>>>>> John
>>>>>>
>>>>>> I think we’re all eager to see what you are working on. We have some
>>>>>> hands willing to help. Can you give an update on this?
>>>>>>
>>>>>> Rob - can you send an email detailing what you’d hope to see in the
>>>>>> documentation as a new dev coming to the project?
>>>>>>
>>>>>> Ed - can you give a perspective on what you already know is not
>>>>>> working in the documentation?
>>>>>>
>>>>>> Thanks
>>>>>>
>>>>>> On Wed, Jun 14, 2023 at 9:42 AM Rob Tompkins <ch...@gmail.com>
>>>>>> wrote:
>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> On Jun 14, 2023, at 10:36 AM, Rob Tompkins <ch...@gmail.com>
>>>>>>> wrote:
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> On Jun 14, 2023, at 5:06 AM, John Gathogo <jo...@fiter.io> wrote:
>>>>>>>
>>>>>>>
>>>>>>> @ed, I am working on streamlining the documentation. I will have
>>>>>>> something for the community to preview soon.
>>>>>>>
>>>>>>>
>>>>>>> I would love to help in whatever capacity I can here. Either as a
>>>>>>> guinea pig or a contributor. Tell me where to run to help :-)
>>>>>>>
>>>>>>>
>>>>>>> One more note here, just so you folks know that im not just being an
>>>>>>> ass….Im one who is of the philosophy that if I make noise then id better be
>>>>>>> willing to help ;-) and do so at the direction of the elders on the project
>>>>>>>
>>>>>>> Cheers,
>>>>>>> -Rob
>>>>>>>
>>>>>>>
>>>>>>> Cheers,
>>>>>>> -Rob
>>>>>>>
>>>>>>> I am not sure if its possible to incorporate the readme in the ascii
>>>>>>> doc documentation...will check with Aleks.
>>>>>>>
>>>>>>> Thanks
>>>>>>>
>>>>>>> On Wed, Jun 14, 2023 at 9:38 AM Ed Cable <ed...@mifos.org> wrote:
>>>>>>>
>>>>>>>> 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 <ed...@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 <ch...@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
>>>>>>>>> edcable@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
>>>>>>>> edcable@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>
>>>>>>>>
>>>>>>>> --
>>>>>> Sent from Gmail Mobile
>>>>>>
>>>>>
Re: On Getting Started with Fineract
Posted by John Gathogo <jo...@fiter.io>.
Hello James,
This was a simple proof of concept to visually show what the end product
will look like. The goal is to consolidate documentation into one place and
make it easier for devs and non devs to add/update content. In my opinion,
only the PMC reports, meeting notes and COMMS content should remain in the
Wiki, the rest should be moved to asciidoc.
In the process of moving it to asciidoc, the content will be reviewed for
accuracy, relevance and datedness, and outdated information should be
removed.
The landing page will be more appealing and include all the major links,
this is what we are aiming for https://camel.apache.org/. We'll start small
and keep improving over time.
Can someone approve my request for JIRA access. Username = ruhiu
Thanks
On Thu, Jul 13, 2023 at 2:32 AM James Dailey <ja...@gmail.com> wrote:
> Hi John
>
> I did find your directory structure by clicking on the "EDIT" link -->
> https://github.com/jogathogo/fineract/edit/1.7.3/fineract-doc/modules/ROOT/pages/index.adoc
>
>
> Please do send a pull request for this so we can see what the diff would
> be.
>
> FAQ
> I have some questions about the FAQ you are proposing?
> The existing FAQ is here ==>
>
> https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=91554327
> Those are frequently asked questions - I try to add to it whenever I get
> another question on the list serv. It changes from time to time.
>
> Was your intention to fully edit that to the following?
> http://34.125.186.48/build/site/modules/1.8/faq.html
>
> because I would want to include the questions and answer structure, since
> its a FAQ.
>
> LANDING PAGE
> The home page at [http://34.125.186.48/build/site/modules/1.8/index.html
> ] should include pretty much all of the content currently at our LANDING
> PAGE https://fineract.apache.org <https://fineract.apache.org>
> including an easy way to get to the releases, github, listserv, jira
> tickets, and links to the Apache foundation as on the footer.
>
> LISTSERV
> The project relies 100% on the listserv as the primary way for developers
> to engage. The instructions for subscribing and unsubscribing should be
> easy to find.
>
>
> Thanks,
>
> On Wed, Jul 12, 2023 at 8:31 AM James Dailey <ja...@gmail.com>
> wrote:
>
>> Hi John - Thank you.
>>
>> I am excited to see this. And, where is the code or folder structure
>> behind this? I think this
>> http://34.125.186.48/build/site/modules/1.8/index.html explains the
>> concept you have to some extent, in a visual way, but how this is built and
>> maintained is very important for us.
>>
>> I believe we need to take this in small bites so that we can maintain the
>> key elements on the wiki that are expected to be there. We will also need
>> to adjust the wiki, there are external links to the wiki which should be
>> respected. (We cannot simply delete them but must create links to the new
>> locations). We need it to be something that can be maintained by you, by
>> me, by anyone coming to the project and can help out.
>>
>> I am not sure I see the relationship between this and the current
>> AsciiDoc setup. How do you conceptualize the two of them working together?
>> What's the structure of the folders or how are you running the scripts? I
>> think that may explain.
>>
>> Where is the Landing page? This is a requirement. There are "rules and
>> norms" from Apache that should be followed with regard to that.
>>
>> I'll accept the Jira request. Anyone on the PMC can approve your request
>> to be added to Jira. To be explicit, and I am certain he agrees, Ed is
>> simply one person on the project.
>>
>> Thanks,
>> James Dailey
>>
>>
>>
>> On Wed, Jul 12, 2023 at 12:03 AM John Gathogo <jo...@fiter.io> wrote:
>>
>>> Use this link http://34.125.186.48/build/site/modules/1.8/index.html
>>>
>>> On Wed, Jul 12, 2023 at 9:39 AM John Gathogo <jo...@fiter.io> wrote:
>>>
>>>> Hello Everyone,
>>>>
>>>> The overall goal of this is to consolidate project documentation into
>>>> one place to give all stakeholders a great user experience.
>>>>
>>>> To do this, I am moving content found in different places like the
>>>> wiki, readme and others to fineract-doc and converting it to asciidoc. The
>>>> idea is to have docs sitting in the same place as code for easier
>>>> maintenance.
>>>>
>>>> A preview of this can be see here
>>>> http://34.125.186.48/build/site/modules/1.8/index.html
>>>>
>>>> I should be able to raise a PR for review and contribution by others by
>>>> early next week.
>>>>
>>>> @edcable@mifos.org <ed...@mifos.org> I requested access to Jira,
>>>> please approve this to allow me create tickets on the fineract jira board.
>>>>
>>>> Thanks,
>>>> Ruhiu
>>>>
>>>> On Wed, Jul 5, 2023 at 5:57 PM James Dailey <ja...@gmail.com>
>>>> wrote:
>>>>
>>>>> John
>>>>>
>>>>> I think we’re all eager to see what you are working on. We have some
>>>>> hands willing to help. Can you give an update on this?
>>>>>
>>>>> Rob - can you send an email detailing what you’d hope to see in the
>>>>> documentation as a new dev coming to the project?
>>>>>
>>>>> Ed - can you give a perspective on what you already know is not
>>>>> working in the documentation?
>>>>>
>>>>> Thanks
>>>>>
>>>>> On Wed, Jun 14, 2023 at 9:42 AM Rob Tompkins <ch...@gmail.com>
>>>>> wrote:
>>>>>
>>>>>>
>>>>>>
>>>>>> On Jun 14, 2023, at 10:36 AM, Rob Tompkins <ch...@gmail.com>
>>>>>> wrote:
>>>>>>
>>>>>>
>>>>>>
>>>>>>
>>>>>> On Jun 14, 2023, at 5:06 AM, John Gathogo <jo...@fiter.io> wrote:
>>>>>>
>>>>>>
>>>>>> @ed, I am working on streamlining the documentation. I will have
>>>>>> something for the community to preview soon.
>>>>>>
>>>>>>
>>>>>> I would love to help in whatever capacity I can here. Either as a
>>>>>> guinea pig or a contributor. Tell me where to run to help :-)
>>>>>>
>>>>>>
>>>>>> One more note here, just so you folks know that im not just being an
>>>>>> ass….Im one who is of the philosophy that if I make noise then id better be
>>>>>> willing to help ;-) and do so at the direction of the elders on the project
>>>>>>
>>>>>> Cheers,
>>>>>> -Rob
>>>>>>
>>>>>>
>>>>>> Cheers,
>>>>>> -Rob
>>>>>>
>>>>>> I am not sure if its possible to incorporate the readme in the ascii
>>>>>> doc documentation...will check with Aleks.
>>>>>>
>>>>>> Thanks
>>>>>>
>>>>>> On Wed, Jun 14, 2023 at 9:38 AM Ed Cable <ed...@mifos.org> wrote:
>>>>>>
>>>>>>> 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 <ed...@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 <ch...@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
>>>>>>>> edcable@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
>>>>>>> edcable@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>
>>>>>>>
>>>>>>> --
>>>>> Sent from Gmail Mobile
>>>>>
>>>>
Re: On Getting Started with Fineract
Posted by James Dailey <ja...@gmail.com>.
Hi John
I did find your directory structure by clicking on the "EDIT" link -->
https://github.com/jogathogo/fineract/edit/1.7.3/fineract-doc/modules/ROOT/pages/index.adoc
Please do send a pull request for this so we can see what the diff would
be.
FAQ
I have some questions about the FAQ you are proposing?
The existing FAQ is here ==>
https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=91554327
Those are frequently asked questions - I try to add to it whenever I get
another question on the list serv. It changes from time to time.
Was your intention to fully edit that to the following?
http://34.125.186.48/build/site/modules/1.8/faq.html
because I would want to include the questions and answer structure, since
its a FAQ.
LANDING PAGE
The home page at [http://34.125.186.48/build/site/modules/1.8/index.html ]
should include pretty much all of the content currently at our LANDING
PAGE https://fineract.apache.org <https://fineract.apache.org>
including an easy way to get to the releases, github, listserv, jira
tickets, and links to the Apache foundation as on the footer.
LISTSERV
The project relies 100% on the listserv as the primary way for developers
to engage. The instructions for subscribing and unsubscribing should be
easy to find.
Thanks,
On Wed, Jul 12, 2023 at 8:31 AM James Dailey <ja...@gmail.com> wrote:
> Hi John - Thank you.
>
> I am excited to see this. And, where is the code or folder structure
> behind this? I think this
> http://34.125.186.48/build/site/modules/1.8/index.html explains the
> concept you have to some extent, in a visual way, but how this is built and
> maintained is very important for us.
>
> I believe we need to take this in small bites so that we can maintain the
> key elements on the wiki that are expected to be there. We will also need
> to adjust the wiki, there are external links to the wiki which should be
> respected. (We cannot simply delete them but must create links to the new
> locations). We need it to be something that can be maintained by you, by
> me, by anyone coming to the project and can help out.
>
> I am not sure I see the relationship between this and the current AsciiDoc
> setup. How do you conceptualize the two of them working together? What's
> the structure of the folders or how are you running the scripts? I think
> that may explain.
>
> Where is the Landing page? This is a requirement. There are "rules and
> norms" from Apache that should be followed with regard to that.
>
> I'll accept the Jira request. Anyone on the PMC can approve your request
> to be added to Jira. To be explicit, and I am certain he agrees, Ed is
> simply one person on the project.
>
> Thanks,
> James Dailey
>
>
>
> On Wed, Jul 12, 2023 at 12:03 AM John Gathogo <jo...@fiter.io> wrote:
>
>> Use this link http://34.125.186.48/build/site/modules/1.8/index.html
>>
>> On Wed, Jul 12, 2023 at 9:39 AM John Gathogo <jo...@fiter.io> wrote:
>>
>>> Hello Everyone,
>>>
>>> The overall goal of this is to consolidate project documentation into
>>> one place to give all stakeholders a great user experience.
>>>
>>> To do this, I am moving content found in different places like the wiki,
>>> readme and others to fineract-doc and converting it to asciidoc. The idea
>>> is to have docs sitting in the same place as code for easier maintenance.
>>>
>>> A preview of this can be see here
>>> http://34.125.186.48/build/site/modules/1.8/index.html
>>>
>>> I should be able to raise a PR for review and contribution by others by
>>> early next week.
>>>
>>> @edcable@mifos.org <ed...@mifos.org> I requested access to Jira,
>>> please approve this to allow me create tickets on the fineract jira board.
>>>
>>> Thanks,
>>> Ruhiu
>>>
>>> On Wed, Jul 5, 2023 at 5:57 PM James Dailey <ja...@gmail.com>
>>> wrote:
>>>
>>>> John
>>>>
>>>> I think we’re all eager to see what you are working on. We have some
>>>> hands willing to help. Can you give an update on this?
>>>>
>>>> Rob - can you send an email detailing what you’d hope to see in the
>>>> documentation as a new dev coming to the project?
>>>>
>>>> Ed - can you give a perspective on what you already know is not working
>>>> in the documentation?
>>>>
>>>> Thanks
>>>>
>>>> On Wed, Jun 14, 2023 at 9:42 AM Rob Tompkins <ch...@gmail.com>
>>>> wrote:
>>>>
>>>>>
>>>>>
>>>>> On Jun 14, 2023, at 10:36 AM, Rob Tompkins <ch...@gmail.com> wrote:
>>>>>
>>>>>
>>>>>
>>>>>
>>>>> On Jun 14, 2023, at 5:06 AM, John Gathogo <jo...@fiter.io> wrote:
>>>>>
>>>>>
>>>>> @ed, I am working on streamlining the documentation. I will have
>>>>> something for the community to preview soon.
>>>>>
>>>>>
>>>>> I would love to help in whatever capacity I can here. Either as a
>>>>> guinea pig or a contributor. Tell me where to run to help :-)
>>>>>
>>>>>
>>>>> One more note here, just so you folks know that im not just being an
>>>>> ass….Im one who is of the philosophy that if I make noise then id better be
>>>>> willing to help ;-) and do so at the direction of the elders on the project
>>>>>
>>>>> Cheers,
>>>>> -Rob
>>>>>
>>>>>
>>>>> Cheers,
>>>>> -Rob
>>>>>
>>>>> I am not sure if its possible to incorporate the readme in the ascii
>>>>> doc documentation...will check with Aleks.
>>>>>
>>>>> Thanks
>>>>>
>>>>> On Wed, Jun 14, 2023 at 9:38 AM Ed Cable <ed...@mifos.org> wrote:
>>>>>
>>>>>> 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 <ed...@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 <ch...@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
>>>>>>> edcable@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
>>>>>> edcable@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>
>>>>>>
>>>>>> --
>>>> Sent from Gmail Mobile
>>>>
>>>
Re: On Getting Started with Fineract
Posted by Juan Manuel Hernández <fd...@gmail.com>.
Hola
Como elimino mi email de aqui?
El El mié, 12 de jul. de 2023 a la(s) 11:33, James Dailey <
jamespdailey@gmail.com> escribió:
> Hi John - Thank you.
>
> I am excited to see this. And, where is the code or folder structure
> behind this? I think this
> http://34.125.186.48/build/site/modules/1.8/index.html explains the
> concept you have to some extent, in a visual way, but how this is built and
> maintained is very important for us.
>
> I believe we need to take this in small bites so that we can maintain the
> key elements on the wiki that are expected to be there. We will also need
> to adjust the wiki, there are external links to the wiki which should be
> respected. (We cannot simply delete them but must create links to the new
> locations). We need it to be something that can be maintained by you, by
> me, by anyone coming to the project and can help out.
>
> I am not sure I see the relationship between this and the current AsciiDoc
> setup. How do you conceptualize the two of them working together? What's
> the structure of the folders or how are you running the scripts? I think
> that may explain.
>
> Where is the Landing page? This is a requirement. There are "rules and
> norms" from Apache that should be followed with regard to that.
>
> I'll accept the Jira request. Anyone on the PMC can approve your request
> to be added to Jira. To be explicit, and I am certain he agrees, Ed is
> simply one person on the project.
>
> Thanks,
>
> James Dailey
>
>
>
> On Wed, Jul 12, 2023 at 12:03 AM John Gathogo <jo...@fiter.io> wrote:
>
>> Use this link http://34.125.186.48/build/site/modules/1.8/index.html
>>
>> On Wed, Jul 12, 2023 at 9:39 AM John Gathogo <jo...@fiter.io> wrote:
>>
>>> Hello Everyone,
>>>
>>> The overall goal of this is to consolidate project documentation into
>>> one place to give all stakeholders a great user experience.
>>>
>>> To do this, I am moving content found in different places like the wiki,
>>> readme and others to fineract-doc and converting it to asciidoc. The idea
>>> is to have docs sitting in the same place as code for easier maintenance.
>>>
>>> A preview of this can be see here
>>> http://34.125.186.48/build/site/modules/1.8/index.html
>>>
>>> I should be able to raise a PR for review and contribution by others by
>>> early next week.
>>>
>>> @edcable@mifos.org <ed...@mifos.org> I requested access to Jira,
>>> please approve this to allow me create tickets on the fineract jira board.
>>>
>>> Thanks,
>>> Ruhiu
>>>
>>> On Wed, Jul 5, 2023 at 5:57 PM James Dailey <ja...@gmail.com>
>>> wrote:
>>>
>>>> John
>>>>
>>>> I think we’re all eager to see what you are working on. We have some
>>>> hands willing to help. Can you give an update on this?
>>>>
>>>> Rob - can you send an email detailing what you’d hope to see in the
>>>> documentation as a new dev coming to the project?
>>>>
>>>> Ed - can you give a perspective on what you already know is not working
>>>> in the documentation?
>>>>
>>>> Thanks
>>>>
>>>> On Wed, Jun 14, 2023 at 9:42 AM Rob Tompkins <ch...@gmail.com>
>>>> wrote:
>>>>
>>>>>
>>>>>
>>>>> On Jun 14, 2023, at 10:36 AM, Rob Tompkins <ch...@gmail.com> wrote:
>>>>>
>>>>>
>>>>>
>>>>>
>>>>> On Jun 14, 2023, at 5:06 AM, John Gathogo <jo...@fiter.io> wrote:
>>>>>
>>>>>
>>>>> @ed, I am working on streamlining the documentation. I will have
>>>>> something for the community to preview soon.
>>>>>
>>>>>
>>>>> I would love to help in whatever capacity I can here. Either as a
>>>>> guinea pig or a contributor. Tell me where to run to help :-)
>>>>>
>>>>>
>>>>> One more note here, just so you folks know that im not just being an
>>>>> ass….Im one who is of the philosophy that if I make noise then id better be
>>>>> willing to help ;-) and do so at the direction of the elders on the project
>>>>>
>>>>> Cheers,
>>>>> -Rob
>>>>>
>>>>>
>>>>> Cheers,
>>>>> -Rob
>>>>>
>>>>> I am not sure if its possible to incorporate the readme in the ascii
>>>>> doc documentation...will check with Aleks.
>>>>>
>>>>> Thanks
>>>>>
>>>>> On Wed, Jun 14, 2023 at 9:38 AM Ed Cable <ed...@mifos.org> wrote:
>>>>>
>>>>>> 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 <ed...@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 <ch...@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
>>>>>>> edcable@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
>>>>>> edcable@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>
>>>>>>
>>>>>> --
>>>> Sent from Gmail Mobile
>>>>
>>>
Re: On Getting Started with Fineract
Posted by James Dailey <ja...@gmail.com>.
Hi John - Thank you.
I am excited to see this. And, where is the code or folder structure
behind this? I think this
http://34.125.186.48/build/site/modules/1.8/index.html explains the concept
you have to some extent, in a visual way, but how this is built and
maintained is very important for us.
I believe we need to take this in small bites so that we can maintain the
key elements on the wiki that are expected to be there. We will also need
to adjust the wiki, there are external links to the wiki which should be
respected. (We cannot simply delete them but must create links to the new
locations). We need it to be something that can be maintained by you, by
me, by anyone coming to the project and can help out.
I am not sure I see the relationship between this and the current AsciiDoc
setup. How do you conceptualize the two of them working together? What's
the structure of the folders or how are you running the scripts? I think
that may explain.
Where is the Landing page? This is a requirement. There are "rules and
norms" from Apache that should be followed with regard to that.
I'll accept the Jira request. Anyone on the PMC can approve your request to
be added to Jira. To be explicit, and I am certain he agrees, Ed is simply
one person on the project.
Thanks,
James Dailey
On Wed, Jul 12, 2023 at 12:03 AM John Gathogo <jo...@fiter.io> wrote:
> Use this link http://34.125.186.48/build/site/modules/1.8/index.html
>
> On Wed, Jul 12, 2023 at 9:39 AM John Gathogo <jo...@fiter.io> wrote:
>
>> Hello Everyone,
>>
>> The overall goal of this is to consolidate project documentation into one
>> place to give all stakeholders a great user experience.
>>
>> To do this, I am moving content found in different places like the wiki,
>> readme and others to fineract-doc and converting it to asciidoc. The idea
>> is to have docs sitting in the same place as code for easier maintenance.
>>
>> A preview of this can be see here
>> http://34.125.186.48/build/site/modules/1.8/index.html
>>
>> I should be able to raise a PR for review and contribution by others by
>> early next week.
>>
>> @edcable@mifos.org <ed...@mifos.org> I requested access to Jira,
>> please approve this to allow me create tickets on the fineract jira board.
>>
>> Thanks,
>> Ruhiu
>>
>> On Wed, Jul 5, 2023 at 5:57 PM James Dailey <ja...@gmail.com>
>> wrote:
>>
>>> John
>>>
>>> I think we’re all eager to see what you are working on. We have some
>>> hands willing to help. Can you give an update on this?
>>>
>>> Rob - can you send an email detailing what you’d hope to see in the
>>> documentation as a new dev coming to the project?
>>>
>>> Ed - can you give a perspective on what you already know is not working
>>> in the documentation?
>>>
>>> Thanks
>>>
>>> On Wed, Jun 14, 2023 at 9:42 AM Rob Tompkins <ch...@gmail.com> wrote:
>>>
>>>>
>>>>
>>>> On Jun 14, 2023, at 10:36 AM, Rob Tompkins <ch...@gmail.com> wrote:
>>>>
>>>>
>>>>
>>>>
>>>> On Jun 14, 2023, at 5:06 AM, John Gathogo <jo...@fiter.io> wrote:
>>>>
>>>>
>>>> @ed, I am working on streamlining the documentation. I will have
>>>> something for the community to preview soon.
>>>>
>>>>
>>>> I would love to help in whatever capacity I can here. Either as a
>>>> guinea pig or a contributor. Tell me where to run to help :-)
>>>>
>>>>
>>>> One more note here, just so you folks know that im not just being an
>>>> ass….Im one who is of the philosophy that if I make noise then id better be
>>>> willing to help ;-) and do so at the direction of the elders on the project
>>>>
>>>> Cheers,
>>>> -Rob
>>>>
>>>>
>>>> Cheers,
>>>> -Rob
>>>>
>>>> I am not sure if its possible to incorporate the readme in the ascii
>>>> doc documentation...will check with Aleks.
>>>>
>>>> Thanks
>>>>
>>>> On Wed, Jun 14, 2023 at 9:38 AM Ed Cable <ed...@mifos.org> wrote:
>>>>
>>>>> 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 <ed...@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 <ch...@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
>>>>>> edcable@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
>>>>> edcable@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>
>>>>>
>>>>> --
>>> Sent from Gmail Mobile
>>>
>>
Re: On Getting Started with Fineract
Posted by John Gathogo <jo...@fiter.io>.
Use this link http://34.125.186.48/build/site/modules/1.8/index.html
On Wed, Jul 12, 2023 at 9:39 AM John Gathogo <jo...@fiter.io> wrote:
> Hello Everyone,
>
> The overall goal of this is to consolidate project documentation into one
> place to give all stakeholders a great user experience.
>
> To do this, I am moving content found in different places like the wiki,
> readme and others to fineract-doc and converting it to asciidoc. The idea
> is to have docs sitting in the same place as code for easier maintenance.
>
> A preview of this can be see here
> http://34.125.186.48/build/site/modules/1.8/index.html
>
> I should be able to raise a PR for review and contribution by others by
> early next week.
>
> @edcable@mifos.org <ed...@mifos.org> I requested access to Jira, please
> approve this to allow me create tickets on the fineract jira board.
>
> Thanks,
> Ruhiu
>
> On Wed, Jul 5, 2023 at 5:57 PM James Dailey <ja...@gmail.com>
> wrote:
>
>> John
>>
>> I think we’re all eager to see what you are working on. We have some
>> hands willing to help. Can you give an update on this?
>>
>> Rob - can you send an email detailing what you’d hope to see in the
>> documentation as a new dev coming to the project?
>>
>> Ed - can you give a perspective on what you already know is not working
>> in the documentation?
>>
>> Thanks
>>
>> On Wed, Jun 14, 2023 at 9:42 AM Rob Tompkins <ch...@gmail.com> wrote:
>>
>>>
>>>
>>> On Jun 14, 2023, at 10:36 AM, Rob Tompkins <ch...@gmail.com> wrote:
>>>
>>>
>>>
>>>
>>> On Jun 14, 2023, at 5:06 AM, John Gathogo <jo...@fiter.io> wrote:
>>>
>>>
>>> @ed, I am working on streamlining the documentation. I will have
>>> something for the community to preview soon.
>>>
>>>
>>> I would love to help in whatever capacity I can here. Either as a guinea
>>> pig or a contributor. Tell me where to run to help :-)
>>>
>>>
>>> One more note here, just so you folks know that im not just being an
>>> ass….Im one who is of the philosophy that if I make noise then id better be
>>> willing to help ;-) and do so at the direction of the elders on the project
>>>
>>> Cheers,
>>> -Rob
>>>
>>>
>>> Cheers,
>>> -Rob
>>>
>>> I am not sure if its possible to incorporate the readme in the ascii doc
>>> documentation...will check with Aleks.
>>>
>>> Thanks
>>>
>>> On Wed, Jun 14, 2023 at 9:38 AM Ed Cable <ed...@mifos.org> wrote:
>>>
>>>> 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 <ed...@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 <ch...@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
>>>>> edcable@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
>>>> edcable@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>
>>>>
>>>> --
>> Sent from Gmail Mobile
>>
>
Re: On Getting Started with Fineract
Posted by John Gathogo <jo...@fiter.io>.
Hello Everyone,
The overall goal of this is to consolidate project documentation into one
place to give all stakeholders a great user experience.
To do this, I am moving content found in different places like the wiki,
readme and others to fineract-doc and converting it to asciidoc. The idea
is to have docs sitting in the same place as code for easier maintenance.
A preview of this can be see here
http://34.125.186.48/build/site/modules/1.8/index.html
I should be able to raise a PR for review and contribution by others by
early next week.
@edcable@mifos.org <ed...@mifos.org> I requested access to Jira, please
approve this to allow me create tickets on the fineract jira board.
Thanks,
Ruhiu
On Wed, Jul 5, 2023 at 5:57 PM James Dailey <ja...@gmail.com> wrote:
> John
>
> I think we’re all eager to see what you are working on. We have some
> hands willing to help. Can you give an update on this?
>
> Rob - can you send an email detailing what you’d hope to see in the
> documentation as a new dev coming to the project?
>
> Ed - can you give a perspective on what you already know is not working in
> the documentation?
>
> Thanks
>
> On Wed, Jun 14, 2023 at 9:42 AM Rob Tompkins <ch...@gmail.com> wrote:
>
>>
>>
>> On Jun 14, 2023, at 10:36 AM, Rob Tompkins <ch...@gmail.com> wrote:
>>
>>
>>
>>
>> On Jun 14, 2023, at 5:06 AM, John Gathogo <jo...@fiter.io> wrote:
>>
>>
>> @ed, I am working on streamlining the documentation. I will have
>> something for the community to preview soon.
>>
>>
>> I would love to help in whatever capacity I can here. Either as a guinea
>> pig or a contributor. Tell me where to run to help :-)
>>
>>
>> One more note here, just so you folks know that im not just being an
>> ass….Im one who is of the philosophy that if I make noise then id better be
>> willing to help ;-) and do so at the direction of the elders on the project
>>
>> Cheers,
>> -Rob
>>
>>
>> Cheers,
>> -Rob
>>
>> I am not sure if its possible to incorporate the readme in the ascii doc
>> documentation...will check with Aleks.
>>
>> Thanks
>>
>> On Wed, Jun 14, 2023 at 9:38 AM Ed Cable <ed...@mifos.org> wrote:
>>
>>> 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 <ed...@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 <ch...@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
>>>> edcable@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
>>> edcable@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>
>>>
>>> --
> Sent from Gmail Mobile
>