From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id MJhONC/mZmF2RAEAgWs5BA (envelope-from ) for ; Wed, 13 Oct 2021 15:59:11 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id 4EQAMC/mZmGhSAAA1q6Kng (envelope-from ) for ; Wed, 13 Oct 2021 13:59:11 +0000 Received: from mail.notmuchmail.org (nmbug.tethera.net [144.217.243.247]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id ED4202330E for ; Wed, 13 Oct 2021 15:59:10 +0200 (CEST) Received: from nmbug.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 982B42C197; Wed, 13 Oct 2021 09:59:07 -0400 (EDT) Received: from fethera.tethera.net (fethera.tethera.net [198.245.60.197]) by mail.notmuchmail.org (Postfix) with ESMTP id 407A52C194 for ; Wed, 13 Oct 2021 09:59:05 -0400 (EDT) Received: by fethera.tethera.net (Postfix, from userid 1001) id 284445FBE5; Wed, 13 Oct 2021 09:59:05 -0400 (EDT) Received: (nullmailer pid 2125415 invoked by uid 1000); Wed, 13 Oct 2021 13:59:03 -0000 From: David Bremner To: Jani Nikula , notmuch@notmuchmail.org Subject: Re: [RFC 0/5] doc: api docs overhaul In-Reply-To: <87fst511p4.fsf@nikula.org> References: <20211012185127.198348-1-jani@nikula.org> <871r4pm83w.fsf@tethera.net> <87fst511p4.fsf@nikula.org> Date: Wed, 13 Oct 2021 10:59:03 -0300 Message-ID: <87lf2xkouw.fsf@tethera.net> MIME-Version: 1.0 Message-ID-Hash: MQW26TUNV5KGRWMXWKOS62OI7W7JCHAU X-Message-ID-Hash: MQW26TUNV5KGRWMXWKOS62OI7W7JCHAU X-MailFrom: david@tethera.net X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-notmuch.notmuchmail.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header X-Mailman-Version: 3.2.1 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1634133551; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=DDJoOx+utqnVkNSmjfUMN8bu3nj7Zf+pL8dXbN3ntlI=; b=F92hA1CHGH6UXzoV88NiydWCnMlAwfr9HhylNYHZ4dwwSl9OvajpCeJDj3L5lx4yWqQ7OQ +V24RL4+oCqSo9I/ibYtchYFdHzAXNpIIuk9DxnCfZQDzyPDag/tFkQJAkQsschtfO+fvn dBzXJiUrpZxrS5SqsCLF2527JexLUgCQffWEkByQQeX5Q/KosTHvNnWqsagL19AmJHXPML nKc7+7jcgAKcFfO8UyVndSQCSExhkz4IvY+RPLTHke1Vhe5oX67HRtgkVFrMTjYPb5x0/i 4kHSu7H1OT5b4ljsNOcGd9/CVg+DgQW8qDh8ERxxdjHe2utkbW1gvE1oLNnkQw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1634133551; a=rsa-sha256; cv=none; b=WybTXHJ8LQjq4NXJ35FFuWgXc/P1hKsBV71XrCw/5qZkOqXiIubZp4kIIv6gGLSxjzhGf5 /t4we9nc1lhc+Fc78FOHCvNnY9TAvI4LWje9GKc73uJyQsBG31OTobqDxWX5Dzzh9Rjx72 +RYStsonDKLAzOGQ/OzlJHldUl0Kndh2JNsmq/Oqn3rWRRjaKXn9GfBATOxl94g2+b/1/r wJEN8JoxLeGWcRDUcYYo4L1wIR7IEwgXQeeH4BJKcddw4BzKUANXg5TKeowwmRKXMPCoK/ W/DKaL1o6aKgdd5W3w+9ATNMHA5L32W0T9kwq/eRcJrXxFX+J6DW1fRPkS2cAA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 144.217.243.247 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Spam-Score: -2.04 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 144.217.243.247 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Queue-Id: ED4202330E X-Spam-Score: -2.04 X-Migadu-Scanner: scn0.migadu.com X-TUID: 0mRE5gK9z1N9 Jani Nikula writes: > > I'm afraid I don't have an answer to that. What do projects do when they > depend on packages from PyPI? It's a kind of chicken and egg problem. I would say python projects would happily _only_ depend on pypi (witness the requests to package notmuch for pypi) but we're not such a project. > > I saw that you made the Debian packaging request; many thanks! But is > that enough? No, it's actually relatively unlikely that someone will volunteer to package it. I could do it myself, but I'd be happier if someone more up on the latest python-in-debian practices would handle it. > What is your stance on imposing new dependencies on other > distros? > Well I just did it with sfsexp. My reasoning was that it was for an optional (for now) new feature, so people were no worse off than before. It's not quite the same thing here, since there is some API docs now. I don't know how many people refer to them. A very rough estimate from Debian [1] is that about 10% of the people who install notmuch also install libnotmuch-dev, which contains the API docs. I guess most people would be happy with a Web version of the API docs, which we don't do now, but which would automagically happen if it was in the sphinx doctree. [1]: https://qa.debian.org/popcon.php?package=notmuch