osdir.com


[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Confluence w Fineract-CN and Fineract


Hi all -

I believe a decision was taken to have both Fineract and the new
Fineract-CN on the same confluence pages and on the same listserv.  Unless
we can get a new Fineract-CN namespace on the apache confluence
established, this means that we will have pages showing up in various
places for Fineract-CN and discussions on this list also covering both code
bases.

My first suggestion - after watching the email traffic for a few months -
is to include in emails and the documentation pages a tag of either
[Fineract-1.x] or [Fineract-CN].   This may be best in the header or merely
somewhere in the top of the message so that it is searchable.  This is
already occurring in the ticketing on jira, right?

My second suggestion is to restructure the pages on
https://cwiki.apache.org/confluence/display/FINERACT.  I think we
should create a structure where Fineract-1.x and Fineract-CN are top level
entries and then all of the content follows as children of those. I'd be
happy to try to work on that.  It means almost everything must be moved one
level deeper, but I think that will help given that this is a rather large
architectural departure.  That said, I know there are a few things that are
shared at the top, i.e.
https://cwiki.apache.org/confluence/display/FINERACT/Committer%27s+Zone and
much of Contributor Zone.

If we don't do this, then I believe we need to tag pages carefully and to
have notes saying "this is Fineract-1.x or Fineract-CN" throughout.  Right
now we have Fineract-CN entries showing up in various places on the pages
and I suspect more will come as we develop that further.  To anticipate -
yes, most of the content is under the page
https://cwiki.apache.org/confluence/display/FINERACT/Fineract+CN but not
all, and in any case, having this be a secondary level where everything
else is Fineract-1.x is confusing.

Lastly, I do believe we should try to have the authoritative fineract and
fineract-CN documentation be sufficient and complete, and therefore a place
where others will link to.

Thanks,
James