From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id A7473CCD183 for ; Tue, 7 Oct 2025 20:52:39 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 2A20E10E714; Tue, 7 Oct 2025 20:52:38 +0000 (UTC) Authentication-Results: gabe.freedesktop.org; dkim=pass (2048-bit key; unprotected) header.d=intel.com header.i=@intel.com header.b="CGD8bH9b"; dkim-atps=neutral Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.18]) by gabe.freedesktop.org (Postfix) with ESMTPS id D74A010E38D for ; Tue, 7 Oct 2025 20:52:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1759870357; x=1791406357; h=date:message-id:from:to:cc:subject:in-reply-to: references:mime-version; bh=MF/hwA5Zf65w++bRAyvpytLXUbMlvO63Nw6ZoLFf3lk=; b=CGD8bH9boLTKf5Yy7D6LkFiVzJfhnRk8FJcD38jpFYt5esB8rW0ZlAkE eMZbFDozgNVEw6L54bQS4zrhbIn685gGB6aMl7cfkB278qqZ2WP3AhRO6 ao00dmfIHIFfc0L0PN/HZad7SZTVPJ2VSqjKp/alI459+3xhzPMyYHD1y 3EcoNNJUc9FYbhlZamdpNAmsWCQZ2gbzomPTq5PM7ssjh8AOtFqIYO5KH ryAyF5uG6rTjK/GroGcVNrYt2fRN7NQ0W5+N1trUCQg6KQmLaDUfizR2K 2jl+MMaP6NHOUKa4V5ZwL7qN28cP83tR/umcmgEDKHp/T4H+4keuf9dXy Q==; X-CSE-ConnectionGUID: zukW/yF0Q7GKsvBNO2scUA== X-CSE-MsgGUID: CQ6VAHZaQPyDZx9EcMgnTw== X-IronPort-AV: E=McAfee;i="6800,10657,11575"; a="61268409" X-IronPort-AV: E=Sophos;i="6.18,321,1751266800"; d="scan'208";a="61268409" Received: from fmviesa002.fm.intel.com ([10.60.135.142]) by fmvoesa112.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 07 Oct 2025 13:52:37 -0700 X-CSE-ConnectionGUID: 1A7CdFWYQGSrmwTym4Thbg== X-CSE-MsgGUID: W7RyarCyTEyYZmInPqwePg== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.18,321,1751266800"; d="scan'208";a="203977570" Received: from unknown (HELO adixit-MOBL3.intel.com) ([10.241.243.202]) by fmviesa002-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 07 Oct 2025 13:52:36 -0700 Date: Tue, 07 Oct 2025 13:52:35 -0700 Message-ID: <87ldlme8oc.wl-ashutosh.dixit@intel.com> From: "Dixit, Ashutosh" To: Jani Nikula Cc: Pawel Sikora , , Petri Latvala , Arkadiusz Hiler , Kamil Konieczny , Juha-Pekka Heikkila , Bhanuprakash Modem , Karthik B S Subject: Re: [PATCH i-g-t v10 0/5] Establish MkDocs Documentation Framework for IGT GPU Tools In-Reply-To: <865f580c0697ef1df5c364841a561475d46aa9ba@intel.com> References: <20250909112741.185825-1-pawel.sikora@intel.com> <865f580c0697ef1df5c364841a561475d46aa9ba@intel.com> User-Agent: Wanderlust/2.15.9 (Almost Unreal) SEMI-EPG/1.14.7 (Harue) FLIM-LB/1.14.9 (=?ISO-8859-4?Q?Goj=F2?=) APEL-LB/10.8 EasyPG/1.0.0 Emacs/30.2 (x86_64-pc-linux-gnu) MULE/6.0 (HANACHIRUSATO) MIME-Version: 1.0 (generated by SEMI-EPG 1.14.7 - "Harue") Content-Type: text/plain; charset=US-ASCII X-BeenThere: igt-dev@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development mailing list for IGT GPU Tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: igt-dev-bounces@lists.freedesktop.org Sender: "igt-dev" On Wed, 10 Sep 2025 01:26:23 -0700, Jani Nikula wrote: > > On Tue, 09 Sep 2025, Pawel Sikora wrote: > > Dear Maintainers, > > > > I am submitting a series of patches to introduce a comprehensive > > documentation framework for the IGT GPU Tools project using MkDocs. > > There's been a lot of iterations in fairly quick succession, and I have > yet to see any comment from maintainers wrt my feedback [1]. > > I'd rather see a clear statement "yeah let's go with MkDocs" than just > having this gradually happen without a conscious decision. I will take a slightly different approach to this. I think Jani has a valid point and if this effort were starting today, I'd say go with sphinx/rst. But as far as I see, this series has required significant effort to get to this point and is almost ready to merge. I don't know how much time/effort it will take for a similar sphinx based solution (Pawel would you know?), but given where we are, it seems we should just merge this (since this would provide some missing documentation immediately). And then if we think we need a sphinx based solution and someone can be found to do that, they can switch the documentation to the sphinx based solution later. I want to elicit Pawel's feedback in particular, since he is the one doing this work. Thanks. -- Ashutosh > > Cc: Everyone from MAINTAINERS. > > > BR, > Jani. > > > [1] https://lore.kernel.org/r/3d83d59669d62f004a507a25510b21f9bd273410@intel.com > > > -- > Jani Nikula, Intel