Skip to content

FINERACT-2555: Add Quick Start section to improve onboarding#5694

Merged
adamsaghy merged 1 commit intoapache:developfrom
tiagosune:improve-readme-quickstart
Mar 26, 2026
Merged

FINERACT-2555: Add Quick Start section to improve onboarding#5694
adamsaghy merged 1 commit intoapache:developfrom
tiagosune:improve-readme-quickstart

Conversation

@tiagosune
Copy link
Copy Markdown
Contributor

This PR introduces a "Quick Start" section to improve the onboarding experience for new contributors.

It provides a simplified and structured guide to set up and run Apache Fineract locally, based on existing instructions in the README.

This section offers a quick overview of the setup process, while detailed instructions remain available below.

@San-43
Copy link
Copy Markdown

San-43 commented Mar 25, 2026

Hello @tiagosune you must sign your commits see -> CONTRIBUTING.md

Also: please follow the rules for pull request title format: "FINERACT-1234: Your title here"...

@tiagosune tiagosune force-pushed the improve-readme-quickstart branch 2 times, most recently from 0543399 to 8308c03 Compare March 25, 2026 20:40
@tiagosune tiagosune force-pushed the improve-readme-quickstart branch from 8308c03 to 6efe21b Compare March 25, 2026 21:53
@tiagosune
Copy link
Copy Markdown
Contributor Author

Hello @tiagosune you must sign your commits see -> CONTRIBUTING.md

Also: please follow the rules for pull request title format: "FINERACT-1234: Your title here"...

Hi, thank you for the feedback!

I have now signed my commits using GPG and updated the commit message to follow the required format (FINERACT-2555).

Please let me know if anything else needs to be adjusted.

@tiagosune tiagosune changed the title Add Quick Start section to improve onboarding FINERACT-2555: Add Quick Start section to improve onboarding Mar 26, 2026
@adamsaghy adamsaghy merged commit 01e7a6a into apache:develop Mar 26, 2026
43 of 44 checks passed
@tiagosune tiagosune deleted the improve-readme-quickstart branch March 26, 2026 16:29

### Prerequisites
- Java 21 or higher
- PostgreSQL or MariaDB running locally
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The instructions as written (e.g. createDB below) will only work with MariaDB or MySQL, but since FSIP-9 has been accepted we should focus on PostgreSQL only.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the feedback!

Since this PR has already been merged, I will create a new JIRA ticket and submit a follow-up PR to update the Quick Start documentation to focus on PostgreSQL as suggested.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The instructions as written (e.g. createDB below) will only work with MariaDB or MySQL, but since FSIP-9 has been accepted we should focus on PostgreSQL only.

Following up on the previous feedback regarding PostgreSQL support, I created a new PR to update the Quick Start section accordingly:

#5701

Please let me know if this aligns with the expected approach or if any adjustments are needed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants