9 Commits

Include renames

Author	SHA1	Message	Date
Adam Monsen	45404bafba	doc: remove errant config but keep :sectlinks: ... See 89e9cfcd7d I think this was a typo. It's presumably changing the highlighter midstream and causing section numbering to start at the "Fineract Development Environment" chapter. But I really like `:sectlinks:` and I want to keep that! It's handy for sharing deep / sorta permanent links to specific sections (just click on any heading and copy the URL).	2025-10-09 10:29:07 -07:00
Adam Monsen	67272d1aea	FINERACT-2336: improve asciidoc post-1.12.1 release ... * update release notice years in NOTICE_RELEASE and NOTICE_SOURCE * step 5 * simplify mention of tests: "Ensure all tests pass for this commit both in CI and locally" * recommend GPG signing annotated release tag * step 8: improve svn commands * This way is simpler and more efficient, especially with a bunch of release candidate dirs in the staging area. * step 10: mention need to test rc before +1 vote -- See: * https://www.apache.org/legal/release-policy.html#release-approval * https://www.apache.org/legal/release-policy.html#approving-a-release * step 12: only PMC members can upload releases * step 13: simplify & explain "finalize branch" instructions * Document what worked for me for 1.12.1. * I didn't need to create the extra `merge-$VERSION` branch and do the recursive merge. * document how asciidoctor upgrade is blocked * see "official docs - deps stuck" thread on fineract dev mailing list * https://lists.apache.org/thread/7mmsj13spb11vgz0z38fhwgzwtq03brr * can't upgrade to 4.x because of one of these: * https://github.com/asciidoctor/asciidoctorj-pdf/issues/25 * https://github.com/jruby/jruby/issues/5573 * https://github.com/asciidoctor/asciidoctorj-pdf/issues/16 * improve asciidoc config - opt for simplicity where the complexity adds nothing * compat-mode is off by default, no need for it here * default optimization should be fine * media should have been screen | print | prepress, just leave it as default instead * page size? I really don't think this is going to be printed much, just go with default * PDF version 1.8 is invalid, just use the default unless we someday have a good reason to pin this * reduce copyright years sources of truth * see also: https://docs.asciidoctor.org/pdf-converter/latest/asciidoc-attributes/ * remove unnecessary asciidoctorj 3.0.0 version string -- no need to pin this * remove prompt character from Bash shell examples * it isn't properly syntax-highlighted and it looks confusing with line numbers (which we might want to add) * it isn't necessary * the prompt character ("%" in this case) is not typically included in shell code examples because it makes it harder to copy and paste shell code examples * $ is likely more common than % (at least on Debian/Ubuntu), but either way I'd say exclude it * fix source code syntax labels - use "bash" only when it is actually Bash shell code * persistence.adoc * fix broken enumerated list * resolves these warnings seen with, e.g.: `gradle --info doc` * `Jul 27, 2025 8:26:48 PM uri:classloader:/gems/asciidoctor-2.0.10/lib/asciidoctor/parser.rb parse_list_item` * `WARNING: chapters/architecture/persistence.adoc: line 104: list item index: expected 1, got 2` * `Jul 27, 2025 8:26:48 PM uri:classloader:/gems/asciidoctor-2.0.10/lib/asciidoctor/parser.rb parse_list` * `WARNING: chapters/architecture/persistence.adoc: line 110: list item index: expected 1, got 3` * fix wrapping (we use hardbreaks) * fix typo: `s/plane text/plain text/` * switch to rouge syntax highlighter - it handles more source languages * fix broken long shell code lines * fix .avro file syntax highlighting (it's JSON) * configuration-gpg.adoc * fix accidental block continuation * One little plus sign was making `= Email` appear verbatim in rendered output because it was interpreted as a list continuation. * See https://docs.asciidoctor.org/asciidoc/latest/lists/continuation/#list-continuation * recommend more secure keys * add a line continuation for an enumerated list * architecture-overview.puml: remove this unused (likely a "Hello World") diagram * release-schedule.puml: fix pluralization of days * purely aesthetic: doesn't affect chart rendering * fix src/bin/binary tarball name typos * missed a few in e090da2a01 * fix release branch name * must match `release/{revnumber}`, per gitVersioning stanza in top level build.gradle * harden.adoc: fix broken link to CISA * fineract-doc/build.gradle * ensure HTML task has diagrams and images availble	2025-08-07 07:02:10 -07:00
Adam Monsen	f28d252f17	FINERACT-2310: collate and improve security documentation ... * fix various typos, spacing, formatting issues * fix links to legacy docs in API docs * update keycloak oauth dev instructions * update default oauth URL for latest Keycloak * use consistent quoting in oauth docs (single quotes) * use asciidoc auto-enumerated lists whenever possible * migrate security topics from readme into asciidoc: oauth, 2FA, HTTPS * move :hardbreaks: setting to config file so all config settings are in one place. (I think it's fine that `license.adoc` will use hardbreaks -- that's how the plain text version is formatted so it should look more familiar) * add intro to security chapter * migrate in Securing Fineract wiki content from https://cwiki.apache.org/confluence/display/FINERACT/Securing+Fineract * just say "oauth" (not "oauth2") to conform terminology throughout docs -- OAuth 2.0 is just the latest version * cross-ref HTTPS section from Securing Fineract * reposition hardening options as tips * see also: https://lists.apache.org/thread/81qdxttffp6wn23c48zvk93hc13373qv * simplify/clarify example oauth curl requests * Testing just now and I didn't need --location. * Also I imagine folks will need --insecure with the self-signed default cert in dev. * don't change default oauth URL * no surprises for existing deployments * clarifies the keycloak v26 example	2025-06-16 15:12:55 -07:00
Aleksandar VidakovicandAleksandar Vidakovic	e4944c44d6	FINERACT-2009: Upgrade latest framework libs	2024-01-06 14:13:33 +01:00
Aleksandar Vidakovic	27489a6850	Prepare release 1.8.0	2022-08-22 12:30:41 +02:00
Aleksandar VidakovicandAleksandar Vidakovic	b0a261cbd5	FINERACT-1608: Add introduction to Asciidoc	2022-05-10 12:12:57 +02:00
Aleksandar VidakovicandAleksandar Vidakovic	40eb547a5c	FINERACT-1470: Fineract release plugin	2022-05-04 15:11:53 +02:00
Arnold GalovicsandAleksandar Vidakovic	7b3ab9bd24	FINERACT-849: Minor fixes + docs for EclipseLink/PostgreSQL support	2022-03-16 18:06:46 +01:00
Aleksandar VidakovicandMichael Vorburger ⛑️	e380df187d	FINERACT-1191: Finceract Documentation in Asciidoc	2020-11-02 21:25:36 +01:00