5 Commits

Include renames

Author	SHA1	Message	Date
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	e090da2a01	FINERACT-2335: don't rename release tarballs ... Release tarballs are currently renamed (without changing the contents): apache-fineract-src-1.12.1.tar.gz becomes apache-fineract-1.12.1-src.tar.gz . The former matches the exploded directory name, the latter does not. The difference is subtle but meaningful... I strongly prefer the former because it's less surprising / more common, and easier to work with from scripts. There's no functional difference, this should only impact aesthetics. I did also shorten `binary` to `bin` so release artifact name lengths match.	2025-07-28 11:04:23 -07:00
Adam MonsenandAdam Saghy	3f2079566c	FINERACT-2219: capture v1.11.0 lessons learned in asciidoc and fineract release plugin ... * don't bother making MD5 files, they aren't necessary * step12 changed, stub it out and reference FINERACT-1817 for future improvements (looks like svn mv is not yet supported) * use latest vote message template, based on https://lists.apache.org/thread/cs5t0ho39ktg2jxr74dqd7fg9nyfcz3k * use more explicit form of `git push` to push release tag, see https://stackoverflow.com/questions/5195859/how-do-you-push-a-tag-to-a-remote-repository-using-git * use consistent language re: tarball, file, artifact, release candidate * fix some source listings that shouldn't be using macro expansion: this messes up URLs (hides scheme) * fix asciidoc link to FINERACT-1229 * clean up copyright years: use variable properly and remove unnecessary extra copyright in preface (it appears directly above, in the license) * de-indent URL in apache license -- this makes the link clickable in rendered HTML and PDF asciidoc outputs	2025-03-24 14:30:21 +01: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