From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id uOCWKhB792RAXQEA9RJhRA:P1 (envelope-from ) for ; Tue, 05 Sep 2023 21:01:36 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id uOCWKhB792RAXQEA9RJhRA (envelope-from ) for ; Tue, 05 Sep 2023 21:01:36 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 3E35C3302F for ; Tue, 5 Sep 2023 21:01:36 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=IJSyu2dM; spf=pass (aspmx1.migadu.com: domain of "help-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="help-guix-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1693940496; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=Trl5NnH6XRdoC/73BwPQKyqdcO2FwVFgWUAK3l7fXts=; b=kSeiXio5LFXJgAKmSNVbxv+gxVv+Jnoi4zQzhhPnIHhxH/ps8+viXRQT7k9OUq59SS2mLd WqZn5NPCBLt03Zb6mjRJlQdxn/8YXC5yIktG/xYC1GMtqTeNn/pRy38cX5ZOCmM+g4kN77 BBcVlU9gM8Ik8/W4aGf/oqTsEMnflAprC31A0KR3PWGcLpq82bnRaCT+rX3u9pLOicMlKf C8r1xb88VB0jBF+HjgReeH8ymsoD4aX0XRvgiPK36Sl9T0VwvuMVSM5tvNCazV6+V1jG1r ZIAwiqNawappWRhZlFq45xhu4B/MifQVv0N7q76KhqjTTTqRyfJwPQB/wYlCiA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1693940496; a=rsa-sha256; cv=none; b=KIYHkM5RZLKVZ9OcnFsUJUIM8eaBv6uY3FODMZt1cTiX/9CpUmYkNvl0xqrOgRthZhVcSY TiPP2gqM2kK8rqcfrT8DK2k7+FDwvu2yhbe9RrBXKpb6CaMP3t7V6Y518zYkuvdjwcay9R 7eAqLIbGpJ42koPsHyx8cnyMeJ3vSBD/NVzHjN4gg7yu+31GQofbL5EDtX3nbyNPUVrTOi VJA56wIHYiFtx36tIZfFFLn5XkGb5yVflyOF+jeDv3C4O3qCTdUA3dzAUNs3zfd81A4oyd wf8lqBf55s0AgNi//z/wrYKrfWCp9O63nfm6rAIGYhhhF32I18hkPxDfYNKIXA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=IJSyu2dM; spf=pass (aspmx1.migadu.com: domain of "help-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="help-guix-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gmail.com Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qdbIW-0006XI-O1; Tue, 05 Sep 2023 15:01:12 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qdbIV-0006X9-Dr for help-guix@gnu.org; Tue, 05 Sep 2023 15:01:11 -0400 Received: from mail-wm1-x329.google.com ([2a00:1450:4864:20::329]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qdbIT-000673-8V for help-guix@gnu.org; Tue, 05 Sep 2023 15:01:11 -0400 Received: by mail-wm1-x329.google.com with SMTP id 5b1f17b1804b1-402ba03c754so7844165e9.0 for ; Tue, 05 Sep 2023 12:01:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1693940468; x=1694545268; darn=gnu.org; h=mime-version:message-id:date:references:in-reply-to:subject:to:from :from:to:cc:subject:date:message-id:reply-to; bh=Trl5NnH6XRdoC/73BwPQKyqdcO2FwVFgWUAK3l7fXts=; b=IJSyu2dMGfBvQjJEZrgyY3SS2yNOouOK7wAvBpTHTb5YYYb6Uowv+dlwSesOcux9Ty lcoeKh/MNr3S9VIUe1jPElo/JZFs1qKNlU60VDBKMLVo00VHtWogYOnj/vTuCyZ6/dwu qb2oZODDhefRoS/aZPpqq4G8CrVlG8sFfliHti5UtnsGwrQrLjD1PnhV36FQE4Wpx1DL k2AYo5mFa8Wim5cVBRzm6Q6i1TJBfJKIcAeZ00vXSb1evKeXUvKOPq9hBNTMFkc+TMfX si99VVUMxkXrvdxKhYsnLHSJ4myF+EjlKAOUqWVLk3FPp7m6RDzYs2iFINhF5H2HWW+n CnGw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1693940468; x=1694545268; h=mime-version:message-id:date:references:in-reply-to:subject:to:from :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=Trl5NnH6XRdoC/73BwPQKyqdcO2FwVFgWUAK3l7fXts=; b=kM0791Yd2rH//3MclQ5/RHratf5qgdcXQe41VNUI5BcUkq6/+PNMizUy5NslZe5TMx kxE5yFOx9bcrRDYIg/hO0I/JymEh604AyhIAHafAPkZv/5O0j/6opfskkg1YwUIN6XFc Fw46/1XnBioezRTH4SEhPX5C2SdphPc6K0Oz9q0XcBtJaf99CzF8XOrkgPzaOVdZzLpH cmFAIaG8xVfhO9B2xUNxJEECf9j074SKlHnAsEGMXSEU3QBrZtp/cySE/kW04FONeWCy V74ZUxl5hEoLbnBj8XILr1YZ3ztDut26bZTTf5W4mXDDutP6c+JRC4CypKMG/64LcBeb wOpg== X-Gm-Message-State: AOJu0Yyyq6gou6p8L57nrIJpZ+afBTEjZur5nf3QcCwtvgq1DT5ER5YI Z0X+6TdarAR8MfgEtBAlW49TZmXtkh4= X-Google-Smtp-Source: AGHT+IH95ck3xzGS3NMcN9PbnM1vN2zYgtd+bu2hx97u1W+Zgfc4lmVuiwu1/Mtmd/sePPrNJGmYBQ== X-Received: by 2002:adf:e5c7:0:b0:31d:3669:1c48 with SMTP id a7-20020adfe5c7000000b0031d36691c48mr9231016wrn.7.1693940467810; Tue, 05 Sep 2023 12:01:07 -0700 (PDT) Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e]) by smtp.gmail.com with ESMTPSA id s12-20020a5d4ecc000000b0031423a8f4f7sm18363948wrv.56.2023.09.05.12.01.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 05 Sep 2023 12:01:07 -0700 (PDT) From: Simon Tournier To: Peter Polidoro , help-guix@gnu.org Subject: Re: Project Documentation Workflow In-Reply-To: <87r0nic5lk.fsf@polidoro.io> References: <87r0nic5lk.fsf@polidoro.io> Date: Tue, 05 Sep 2023 19:51:28 +0200 Message-ID: <86jzt4qzj3.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2a00:1450:4864:20::329; envelope-from=zimon.toutoune@gmail.com; helo=mail-wm1-x329.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-guix@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-guix-bounces+larch=yhetil.org@gnu.org Sender: help-guix-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Scanner: mx0.migadu.com X-Migadu-Spam-Score: -9.11 X-Spam-Score: -9.11 X-Migadu-Queue-Id: 3E35C3302F X-TUID: 89VjbRfnyoYx Hi, On Fri, 01 Sep 2023 at 10:18, Peter Polidoro wrote: > I could solve this using Git tools, such as submodules or subtrees > perhaps. I could have a repository that is the documentation > skeleton and each project repository would have a reference to > that skeleton repository. Then I would probably need to write some > script to combine the local project files with the skeleton files > to generate the specific project documentation. Well, from my understanding, you are describing a specific build system for your documentation. :-) > I am wondering if a better approach might be to create a Guix > package containing the documentation skeleton and each project > inherits that package and applies local changes before generating > the project documentation. I have not yet used Guix home, but > perhaps that can be used for projects as well as home directories > for such tasks? Yeah, maybe having these documentation for each project as Guix packages, you could share the common build system (script for building the documentation) and inherit from one package to the other depending on these projects. Well, I have never needed to build many documentation. :-) Cheers, simon