[{"id":39016,"web_url":"https://patchwork.libcamera.org/comment/39016/","msgid":"<178102063746.1255858.13328963854093663191@localhost>","date":"2026-06-09T15:57:17","subject":"Re: [RFC/PATCH 1/3] Documentation: Reorganize the index of the \"For\n\tDevelopers\" section","submitter":{"id":184,"url":"https://patchwork.libcamera.org/api/people/184/","name":"Stefan Klug","email":"stefan.klug@ideasonboard.com"},"content":"Hi Laurent,\n\nThank you for the patch.\n\nQuoting Laurent Pinchart (2026-01-26 20:01:39)\n> The section of the index aimed at developers starts with the\n> contribution guide, and only lists the libcamera architecture page\n> futher down. Reorganize it to start with the \"getting starting\" page,\n> which, as its name implies, is meant to be a good entry point, and\n> continue with the architecture and guides before the more specialized\n> documentation.\n> \n> Signed-off-by: Laurent Pinchart \n> ---\n> Documentation/index.rst | 8 ++++----\n> 1 file changed, 4 insertions(+), 4 deletions(-)\n> \n> diff --git a/Documentation/index.rst b/Documentation/index.rst\n> index 8109b4295c92..03c3d0b4aff6 100644\n> --- a/Documentation/index.rst\n> +++ b/Documentation/index.rst\n> @@ -19,12 +19,12 @@\n> :maxdepth: 1\n> :caption: For Developers\n> \n> - Contribute \n> Getting Started \n> - Camera Sensor Model \n> - IPA Writer's guide \n> - libcamera Architecture \n> + Architecture \n> Pipeline Handler Writer's Guide \n> + IPA Writer's guide \n> + Contribute \n> + Camera Sensor Model \n\nI think I would have put the Contribute page either at the end or after\nthe getting started as it is a bit of an outlier. But I don't care too\nmuch.\n\nReviewed-by: Stefan Klug \n\n> SoftwareISP Benchmarking \n> Tracing guide \n> Design document: AE \n> -- \n> Regards,\n> \n> Laurent Pinchart\n>","headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 3AB9AC328C\n\tfor ;\n\tTue, 9 Jun 2026 15:57:23 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 6C2DE61EF7;\n\tTue, 9 Jun 2026 17:57:22 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id EA08F61EEC\n\tfor ;\n\tTue, 9 Jun 2026 17:57:19 +0200 (CEST)","from ideasonboard.com (unknown\n\t[IPv6:2a00:6020:448c:6c00:7166:b010:3a1b:6311])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 670511E7;\n\tTue, 9 Jun 2026 17:56:51 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"sHwjmaLt\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1781020611;\n\tbh=vqCRwPgmhmIHw9Byi1XHOW4uH7r5bgOmiS200kYPcno=;\n\th=In-Reply-To:References:Subject:From:To:Date:From;\n\tb=sHwjmaLtgcxaE1CSY6dfI0xepmekjtiIh2hrA+ldwPXz+3kIpn03inar6qGzcak6x\n\tYyV6cJw5kBo9TtdYF4UgePezIjTmEJpHg89TNkI+GEvOJrK/Hhgd1p8/EHooHTPKlQ\n\t8H0iR911+jY+jqFVJM/oMJCNxyKhFS4wJAEKjlWE=","Content-Type":"text/plain; charset=\"utf-8\"","MIME-Version":"1.0","Content-Transfer-Encoding":"quoted-printable","In-Reply-To":"<20260126190141.2410546-2-laurent.pinchart@ideasonboard.com>","References":"<20260126190141.2410546-1-laurent.pinchart@ideasonboard.com>\n\t<20260126190141.2410546-2-laurent.pinchart@ideasonboard.com>","Subject":"Re: [RFC/PATCH 1/3] Documentation: Reorganize the index of the \"For\n\tDevelopers\" section","From":"Stefan Klug ","To":"Laurent Pinchart ,\n\tlibcamera-devel@lists.libcamera.org","Date":"Tue, 09 Jun 2026 17:57:17 +0200","Message-ID":"<178102063746.1255858.13328963854093663191@localhost>","User-Agent":"alot/0.12.dev43+g2cacc0d03","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "}},{"id":39020,"web_url":"https://patchwork.libcamera.org/comment/39020/","msgid":"<20260609162131.GC1125735@killaraus.ideasonboard.com>","date":"2026-06-09T16:21:31","subject":"Re: [RFC/PATCH 1/3] Documentation: Reorganize the index of the \"For\n\tDevelopers\" section","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/people/2/","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"content":"On Tue, Jun 09, 2026 at 05:57:17PM +0200, Stefan Klug wrote:\n> Quoting Laurent Pinchart (2026-01-26 20:01:39)\n> > The section of the index aimed at developers starts with the\n> > contribution guide, and only lists the libcamera architecture page\n> > futher down. Reorganize it to start with the \"getting starting\" page,\n> > which, as its name implies, is meant to be a good entry point, and\n> > continue with the architecture and guides before the more specialized\n> > documentation.\n> > \n> > Signed-off-by: Laurent Pinchart \n> > ---\n> > Documentation/index.rst | 8 ++++----\n> > 1 file changed, 4 insertions(+), 4 deletions(-)\n> > \n> > diff --git a/Documentation/index.rst b/Documentation/index.rst\n> > index 8109b4295c92..03c3d0b4aff6 100644\n> > --- a/Documentation/index.rst\n> > +++ b/Documentation/index.rst\n> > @@ -19,12 +19,12 @@\n> > :maxdepth: 1\n> > :caption: For Developers\n> > \n> > - Contribute \n> > Getting Started \n> > - Camera Sensor Model \n> > - IPA Writer's guide \n> > - libcamera Architecture \n> > + Architecture \n> > Pipeline Handler Writer's Guide \n> > + IPA Writer's guide \n> > + Contribute \n> > + Camera Sensor Model \n> \n> I think I would have put the Contribute page either at the end or after\n> the getting started as it is a bit of an outlier. But I don't care too\n> much.\n\nI think we need to further refactor the documentation as the second half\nof the entries looks more like a bunch of losely-connected information.\n\nI'll move the Contribute section to the end.\n\n> Reviewed-by: Stefan Klug \n> \n> > SoftwareISP Benchmarking \n> > Tracing guide \n> > Design document: AE ","headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 6C22DC324C\n\tfor ;\n\tTue, 9 Jun 2026 16:21:35 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 8C6AC61EF1;\n\tTue, 9 Jun 2026 18:21:34 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 302946139A\n\tfor ;\n\tTue, 9 Jun 2026 18:21:33 +0200 (CEST)","from killaraus.ideasonboard.com\n\t(2001-14ba-70f3-e800--a06.rev.dnainternet.fi\n\t[IPv6:2001:14ba:70f3:e800::a06])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 7AD6C244;\n\tTue, 9 Jun 2026 18:21:04 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"rKFl3iDR\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1781022064;\n\tbh=JujgODkQ9lQ9itefes2HQKLBj3rwDPumEge6wb0Kc7w=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=rKFl3iDRCFLmE3k7pMnoKEXHIZMgW3z4S6SbbpUQrpYbtaQEdzmhWag8fmU4YYyWm\n\tB6pUkecoQJZOxoKPCkF+9XlHEsRhmuoju3YWUMjmyS2+Ui65driegoFNctNWvR/tah\n\t1aEdIJR0JBKx4fBfuqMPmPHU1Bd4bqnlk/f/RhJ8=","Date":"Tue, 9 Jun 2026 19:21:31 +0300","From":"Laurent Pinchart ","To":"Stefan Klug ","Cc":"libcamera-devel@lists.libcamera.org","Subject":"Re: [RFC/PATCH 1/3] Documentation: Reorganize the index of the \"For\n\tDevelopers\" section","Message-ID":"<20260609162131.GC1125735@killaraus.ideasonboard.com>","References":"<20260126190141.2410546-1-laurent.pinchart@ideasonboard.com>\n\t<20260126190141.2410546-2-laurent.pinchart@ideasonboard.com>\n\t<178102063746.1255858.13328963854093663191@localhost>","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","In-Reply-To":"<178102063746.1255858.13328963854093663191@localhost>","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "}}]