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

Re: Confluence w Fineract-CN and Fineract

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,
On Thu, Jul 5, 2018 at 8:48 PM James Dailey <jamespdailey@xxxxxxxxx> 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