I am looking at tackling documentation issues and found the current split
of everything to be redundant and a bit scattered at points.  For the sake
of illustration, consider the menu categories on the home page
Documentation, Community, and Development.

What I propose is a cleaner delineation between subjects.  Some of this is
mere semantics and consistency, but I think helps to give a clearer picture.

High level, I think our guides should be more tailored toward the community
and contributions.

Accordingly, I think the NiFi Developer's guide needs to be viewed more as
a manual.  A minor distinction, but I see this provided to users who may
extend the software without necessarily contributing back.

How does this manifest itself?  Mostly just some reshuffling.

* Documentation
This largely remains the same, but the Developer Guide's segments
pertaining to contribution should be moved out.  Let the Developer Guide
focus on the core technical matters.  In its current form, the contributor
items feel out of place.

* Community
We've had some great contributions between blog posts and videos, but there
is no way to showcase these short of searching across social media.  I
would advocate for a page that highlights these items.

* Development
The new home for the contributor's guide for development and additional
guides as needed, such as documentation.

Reply via email to