From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS3215 2.6.0.0/16 X-Spam-Status: No, score=-3.8 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_CSS,URIBL_CSS_A shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from out1.vger.email (out1.vger.email [IPv6:2620:137:e000::1:20]) by dcvr.yhbt.net (Postfix) with ESMTP id 7F5051F54E for ; Mon, 18 Jul 2022 16:54:39 +0000 (UTC) Authentication-Results: dcvr.yhbt.net; dkim=pass (1024-bit key; unprotected) header.d=pobox.com header.i=@pobox.com header.b="p6uftaIY"; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233635AbiGRQyc (ORCPT ); Mon, 18 Jul 2022 12:54:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48856 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233673AbiGRQyb (ORCPT ); Mon, 18 Jul 2022 12:54:31 -0400 Received: from pb-smtp20.pobox.com (pb-smtp20.pobox.com [173.228.157.52]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 32EAABF56 for ; Mon, 18 Jul 2022 09:54:29 -0700 (PDT) Received: from pb-smtp20.pobox.com (unknown [127.0.0.1]) by pb-smtp20.pobox.com (Postfix) with ESMTP id 95C4C1B2FE4; Mon, 18 Jul 2022 12:54:28 -0400 (EDT) (envelope-from junio@pobox.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type:content-transfer-encoding; s=sasl; bh=dbBqrrdp2Zar omdEBbxr8FjNBTUOBMgN3C1aW05DhSM=; b=p6uftaIY3O+80JaHvfsigniyCcqa t9C257YVkgxPdlCCjIUmxHgic3cr6Cy14HZYD/eKgysWke+r971pYm4cuS3wPLwE pxAcLhoxX6ahwuBiKyNjZRiYnpNWXFTPcAJNSCtPjK2hhaui0Bj5DbopCIIN5lup CU9s47tyNavA3IM= Received: from pb-smtp20.sea.icgroup.com (unknown [127.0.0.1]) by pb-smtp20.pobox.com (Postfix) with ESMTP id 8DC121B2FE3; Mon, 18 Jul 2022 12:54:28 -0400 (EDT) (envelope-from junio@pobox.com) Received: from pobox.com (unknown [34.83.92.57]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by pb-smtp20.pobox.com (Postfix) with ESMTPSA id 3E6F01B2FE2; Mon, 18 Jul 2022 12:54:25 -0400 (EDT) (envelope-from junio@pobox.com) From: Junio C Hamano To: =?utf-8?B?w4Z2YXIgQXJuZmrDtnLDsA==?= Bjarmason Cc: git@vger.kernel.org, Eric Sunshine , Philippe Blain , Derrick Stolee , Taylor Blau , Jeff King , Teng Long Subject: Re: [PATCH v4 0/8] git doc + "git help": move "format" docs from technical/* References: Date: Mon, 18 Jul 2022 09:54:24 -0700 In-Reply-To: (=?utf-8?B?IsOGdmFyIEFybmZqw7Zyw7A=?= Bjarmason"'s message of "Mon, 18 Jul 2022 15:29:26 +0200") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 X-Pobox-Relay-ID: 4790F078-06BA-11ED-8A47-C85A9F429DF0-77302942!pb-smtp20.pobox.com Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org =C3=86var Arnfj=C3=B6r=C3=B0 Bjarmason writes: > This series improves the discoverability of the technical/* > documentation covering those "formats" where we interact with users > (e.g. "gitattributes") by moving them to its own "git help" category. > > It then moves various technical documentation from technical/* to our > main documentation namespace, allowing us to cross-link e.g. from > "git-bundle(1)" to a new "gitformat-bundle(5)". This may be a good direction to go in in the longer term, but there are already topics in flight that change these documents. Luckily none in 'next' yet, but there are two that have been in 'seen' and need to coordinate with this change.