Confluence w Fineract-CN and Fineract

[James Dailey <ja...@gmail.com>]

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

Re: Confluence w Fineract-CN and Fineract

[Myrle Krantz <my...@apache.org>]

Hey James,

As you've noted, Fineract CN already has it's own area.  Fineract 1.x
is doing a bit more manspreading, but given that it was there first,
that's understandable.  If Fineract CN content has strayed, that's
also normal when volunteers contribute things without fully
understanding the structure.  I could only find one such article
though, and that was in the user zone.  I don't have any objections to
you wrangling that one.

As I see it, top-level entries should be:
* Committer's Zone
* Contributor's Zone
* Project Management
* Release Management
* 1.x
* CN
* Requirements

That's nearly what we already have.

Best Regards,
Myrle
On Thu, Jul 5, 2018 at 8:48 PM James Dailey <ja...@gmail.com> wrote:
>
> 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