From dev-return-9510-archive-asf-public=cust-asf.ponee.io@airflow.apache.org Thu Oct 3 09:38:41 2019 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with SMTP id E08E318065B for ; Thu, 3 Oct 2019 11:38:40 +0200 (CEST) Received: (qmail 61871 invoked by uid 500); 3 Oct 2019 09:38:39 -0000 Mailing-List: contact dev-help@airflow.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@airflow.apache.org Delivered-To: mailing list dev@airflow.apache.org Received: (qmail 61859 invoked by uid 99); 3 Oct 2019 09:38:39 -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; Thu, 03 Oct 2019 09:38:39 +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 E6B18C10BB for ; Thu, 3 Oct 2019 09:38:38 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -0.2 X-Spam-Level: X-Spam-Status: No, score=-0.2 tagged_above=-999 required=6.31 tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=disabled Authentication-Results: spamd1-us-west.apache.org (amavisd-new); dkim=pass (1024-bit key) header.d=polidea.com Received: from mx1-he-de.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id 6AGFRoLSn9fk for ; Thu, 3 Oct 2019 09:38:36 +0000 (UTC) Received-SPF: Pass (mailfrom) identity=mailfrom; client-ip=2a00:1450:4864:20::22a; helo=mail-lj1-x22a.google.com; envelope-from=kamil.bregula@polidea.com; receiver= Received: from mail-lj1-x22a.google.com (mail-lj1-x22a.google.com [IPv6:2a00:1450:4864:20::22a]) by mx1-he-de.apache.org (ASF Mail Server at mx1-he-de.apache.org) with ESMTPS id 055507DE24 for ; Thu, 3 Oct 2019 09:38:35 +0000 (UTC) Received: by mail-lj1-x22a.google.com with SMTP id m13so1891721ljj.11 for ; Thu, 03 Oct 2019 02:38:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=polidea.com; s=google; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=4mljSzqnyQh5wsM0dsuyYX26RjkcTKg+/CSNdCp9T7A=; b=sDLvc2pntevs6tdAoraW5/5acTlQeM/GTfrqsDMQvvq+mryuAHYrcN+pjW32RGarIN ZtxZ4PwzRvD2cq/FtJmCtVJ7s/7HCF7ywWa920+s/hg3KsF+MDeF5t7emgC75lVR/rR4 7d+jtNOPalHxNLqaBMp2VHwQUMqK2pb31inc4= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=4mljSzqnyQh5wsM0dsuyYX26RjkcTKg+/CSNdCp9T7A=; b=N0jVaVAmwc0UWSwc5K+YQiDKHzoZI+IOKk4Bl1eHIEy6yH3nBXPAlXY05V20YuIofW 8mie30cybwMXvhoHK+NTnSd5bbaWXpx7ZDVm+ewNZDJ5TbLMFoEncq6EfN6ZqQB+vcZj zYaY9ESTwXhZo8Nb/3TCGHGZHUE1M4kdXaTiMkh5hfXcs1B74N0PdeqGkDG3OBvas+SH I4n1lg3r9zXT9vGJwAplTdqoapKm+ZHLOEomfUI9CWQXQeiOG7QSTWlLJQDqPgkwQFzD EdDHmeEo02enfY5sqZEY9O6CQ1s1KsjI4bLrS343DPuZ8G/C2gQBH5lmSvIDgDysm2g2 0F3w== X-Gm-Message-State: APjAAAXNSFpm0ZxCqkuKUhwF2pht0+HZRFn+k/iuFhLEBB0C2aZZNNqU LFxjT9dVGnxOFQ8ThSjEciDkqP+2sijuS1lVuPxg9A== X-Google-Smtp-Source: APXvYqxRHuoUCLdJISo9tq9xfnL+1xi+lU8vDSeQW8Oh0QjGHsb98hpfWuM5OClm0O84Vcb7/NG680epcvu7rE9XPFI= X-Received: by 2002:a2e:1648:: with SMTP id 8mr5108369ljw.194.1570095515273; Thu, 03 Oct 2019 02:38:35 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: =?UTF-8?Q?Kamil_Bregu=C5=82a?= Date: Thu, 3 Oct 2019 11:38:24 +0200 Message-ID: Subject: Re: Refactor integration.rst and full list of operators and hooks To: Felix Uellendall Cc: dev@airflow.apache.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Reply inline On Thu, Oct 3, 2019 at 11:32 AM Felix Uellendall w= rote: > > Kamil, I am not sure what the next steps towards the docs are but should = we already update the Pull Request Template and add a reference to the upda= ted section? I think this would make it easier to find the related docs. I = am not sure how much we want to describe in that template. > I wanted to add an automatic check if a new file appeared, it was added to integration.rst. In this case, the check will take place on CI and you will not need to add additional information for users. If you have suggestions for improvement, you can submit them via PR: https://github.com/apache/airflow/edit/master/.github/PULL_REQUEST_TEMPLATE= .md > Speaking of this I am feeling that the template also could need some impr= ovements. In some projects I have seen some kind of GitHub App / bot e.g in= Flink which checks the PR description. Maybe this can be useful to us, too= ? > I always support any automation that may be helpful to us. > Felix > > Sent from ProtonMail Mobile > > On Thu, Oct 3, 2019 at 09:48, Kamil Bregu=C5=82a wrote: > > > Hello, > > > > I would like to inform you that we have order in the integration.rst fi= le. > > https://airflow.readthedocs.io/en/latest/integration.html > > > > As part of the work, a list of hooks and operators was extracted to a > > separate file and missing integration have been added. > > https://airflow.readthedocs.io/en/latest/operators-and-hooks-ref.html > > > > I would ask all contributors to add new operators and hooks if > > appropriate. This file can reduce the number of questions like - "is > > there operator A in Airflow" or others. > > > > As part of the work, there was also a question of backwards > > compatibility of documentation links. > > https://github.com/apache/airflow/pull/6213#pullrequestreview-294842382 > > If anyone is interested, I invite you to discuss. > > > > Thanks