Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 95210200C54 for ; Wed, 12 Apr 2017 18:03:58 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 9390A160B95; Wed, 12 Apr 2017 16:03:58 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id DBC6E160B8A for ; Wed, 12 Apr 2017 18:03:57 +0200 (CEST) Received: (qmail 31774 invoked by uid 500); 12 Apr 2017 16:03:57 -0000 Mailing-List: contact dev-help@nifi.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@nifi.apache.org Delivered-To: mailing list dev@nifi.apache.org Received: (qmail 31762 invoked by uid 99); 12 Apr 2017 16:03:56 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd1-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 12 Apr 2017 16:03:56 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd1-us-west.apache.org (ASF Mail Server at spamd1-us-west.apache.org) with ESMTP id 62924CFA38 for ; Wed, 12 Apr 2017 16:03:56 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -0.397 X-Spam-Level: X-Spam-Status: No, score=-0.397 tagged_above=-999 required=6.31 tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=2, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-2.796, RCVD_IN_SORBS_SPAM=0.5, SPF_PASS=-0.001] autolearn=disabled Authentication-Results: spamd1-us-west.apache.org (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com Received: from mx1-lw-eu.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id fvm9U1c9b30t for ; Wed, 12 Apr 2017 16:03:55 +0000 (UTC) Received: from mail-io0-f180.google.com (mail-io0-f180.google.com [209.85.223.180]) by mx1-lw-eu.apache.org (ASF Mail Server at mx1-lw-eu.apache.org) with ESMTPS id BC63C5FC5D for ; Wed, 12 Apr 2017 16:03:54 +0000 (UTC) Received: by mail-io0-f180.google.com with SMTP id r16so45076022ioi.2 for ; Wed, 12 Apr 2017 09:03:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to; bh=rjoG3AXL2TqKKLockYvKoTEibtqyF/bVg3Hx0Q47jW8=; b=Yy01pNmFz5XYoKMvLoHgvL0jm7/8abeAsrOhRKpZ6SEBBiGWKJxc7eaKf5nOcJfV7o V3zpQlSSG9/vltgZJigXBjUsrdMFeREgycCWbpyugBKhMle086yiGBXKmZVwgddeR8MX r99isZhGhVmrgIQBCRao8Ao5inyD0XW5cmsaC34Se/vU/1INeUFN0MGd/3d/1fxNBi5j H8kyJX6s8vVAJgqvmU1ATd+tjWH6HbLEF2Cw+8KJ0THNk7AofUvcTkg3mctWfDYXLNBV lKTR+7SVPD9ZI/XgjOguuALZULx9hWmNjjUAB68IzbKQM4D9i4n9s8hZzIFuAmI/wbxn Caag== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to; bh=rjoG3AXL2TqKKLockYvKoTEibtqyF/bVg3Hx0Q47jW8=; b=B+yAylhadC5ICJKwtrPqsYGD0X1KwrloKgpRYgjZTDY8VHvqNmmHnbUES3Irh/YaXL wHs+7ahnbjvd5+i68xKprWPJ0uFRMZNowOgd5551K40eIX5wbpESciP7E5QOVjXrnrQ3 70+BamFycg81SIH/Vfg6L/w8VDRGeTGh/0B4fSe2tPbbTIj4q5mcPZld6fB/ZXdDhmKG J3H7OuFUxk2tTY4YwuSilzQtS+L80GSO2mClIrF0TY2To9vkCc3sLkrbD7H1y9PScX51 0N2rU87QoOhqQpBIWBYyN0mDhpjhcQKmusiNS6xy8DwWAOyDYjYPQIMnhukExYRQhUlj xF/A== X-Gm-Message-State: AN3rC/4iqlMWkotry73oc9i3J4bn7+qRPxH2dntAMBEO+iUOutjSe7YRStg2mocruzDtsuAT4Rj+wdqoUYTZBg== X-Received: by 10.107.6.224 with SMTP id f93mr13891671ioi.210.1492013012596; Wed, 12 Apr 2017 09:03:32 -0700 (PDT) MIME-Version: 1.0 Received: by 10.36.136.6 with HTTP; Wed, 12 Apr 2017 09:03:32 -0700 (PDT) In-Reply-To: References: From: James Wing Date: Wed, 12 Apr 2017 09:03:32 -0700 Message-ID: Subject: Re: Documentation for 1.x To: NiFi Dev List Content-Type: multipart/alternative; boundary=001a113fb6329de37b054cfa5927 archived-at: Wed, 12 Apr 2017 16:03:58 -0000 --001a113fb6329de37b054cfa5927 Content-Type: text/plain; charset=UTF-8 Mark, Would you please open a JIRA ticket for known doc issues and feedback ( https://issues.apache.org/jira/browse/NIFI/)? I do not know if anyone is actively doing such a review at this minute, but the documentation is frequently updated as contributions come in. By the way, we are always looking for contributors :). Even if you don't know the specific answers that should go into the documentation, sharing your experiences of frustration are definitely valuable feedback for improvements. A good ticket is a great contribution on its own. Thanks, James On Wed, Apr 12, 2017 at 8:54 AM, Mark Bean wrote: > I have been asking many questions lately regarding NiFi 1.x because we are > in the process of more deliberately evaluating 1.x as it relates to our > current production level flows. In the process, I have found the > documentation to be incomplete, sometimes incorrect (e.g. typo), contain > references to 0.x-specific items and generally lacking information (e.g. > "In the future, we hope to provide supplemental documentation that covers > the NiFi Cluster Architecture in depth.") IMO, the guides are not always > sufficient to a novice user, but require pre-existing knowledge or > experience to read between the lines. > > In general, I think the provided documentation (starting with the Admin and > User Guides) could use a thorough review and update. Is this something that > is on anyone's the "hit list"? If someone picks this up, I could provide > feedback in a more directed way rather than spamming the mailing list. > > Thanks, > Mark > --001a113fb6329de37b054cfa5927--