Aldrin, Just a heads up if you didn't see the other email thread but I have been I touch with INFRA so we should be able to transition to the updated site soon. I will send out another note as we progress.
Matt Sent from my iPhone > On Mar 28, 2015, at 8:14 AM, Jennifer Barnabee <[email protected]> > wrote: > > +1 on your reshuffling proposals. > > The documentation currently on the site is not up-to-date. I have to admit > that I don't know how to post up the most recent docs myself. Are there > instructions somewhere? > > -Jenn > >> On Thu, Mar 26, 2015 at 9:53 PM, Aldrin Piri <[email protected]> wrote: >> >> 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. >>
