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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 447CDC433FE for ; Thu, 27 Jan 2022 11:31:50 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S240392AbiA0Lbt (ORCPT ); Thu, 27 Jan 2022 06:31:49 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35850 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S240383AbiA0Lbt (ORCPT ); Thu, 27 Jan 2022 06:31:49 -0500 Received: from mail-wm1-x329.google.com (mail-wm1-x329.google.com [IPv6:2a00:1450:4864:20::329]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C4221C06173B for ; Thu, 27 Jan 2022 03:31:48 -0800 (PST) Received: by mail-wm1-x329.google.com with SMTP id c192so1668741wma.4 for ; Thu, 27 Jan 2022 03:31:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=date:from:to:cc:subject:message-id:mail-followup-to:references :mime-version:content-disposition:in-reply-to; bh=hkClxaa+2C8a0Gjj8wVr84ck/Y/nk6VOxGU9yJzk5zg=; b=LiJaUPMq92a9bfWZNpvKXwGghvP4zSBcAMDzeZ/ReWu44m0+N68+ddiTjdr8P02zXx zaH+11MhDX1nAmKSJIcan2E3OYlZzK6odIWYyzvDS+K83UQ/qJ4v4DJDbLTFOHFhGkWT RizQFMxXQrQ3WuwfTgWdmBr6i5ncNvUlw8Me0= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:date:from:to:cc:subject:message-id :mail-followup-to:references:mime-version:content-disposition :in-reply-to; bh=hkClxaa+2C8a0Gjj8wVr84ck/Y/nk6VOxGU9yJzk5zg=; b=2Yx72mX+9wWOf3xFk2XZ/pXbTE9ZK7Uazbwdqn1udu7DDOtosMJaAQXATL/1dOs7// XZ76QUdUVgZbBCDIhIYAHFhlXhpyTgdHcVe7zaSZxp+Bo46MbZJuMpJBMbn70XfD3hk2 D5LA0uC2fNpgcRZEo29rhpSt0r/PGN+bBP70cbm6sZNiEIJxgQxHWDk9vH5dYnAd0zXq pS9um+aW9V/3aQ70GizLGg4nrc1pOvil2+47C+H7Vfo2fts4I+XwYNN41+/ALGrwNcbx gUL07gX4Lcbp5mEJdvfQxFnllz96tNkQNe9iwkQ6lTp03ZhM10MW8BR126KQHZKrLLId 434w== X-Gm-Message-State: AOAM531KJ1wbJoUKlYSOHLYgzabzUWwchORLWjfGi2lZ5fYp3MhREuM0 liAubDvr1tD3RoguIm3raL/kbQ== X-Google-Smtp-Source: ABdhPJzsSgHQc4/Sisg9p2IJQo1l/N+Y/KjTBTOmd8sk+y5btszDk60YCnmxc1l3iGgHjdXMSGgnwg== X-Received: by 2002:a1c:7903:: with SMTP id l3mr2780924wme.43.1643283107438; Thu, 27 Jan 2022 03:31:47 -0800 (PST) Received: from phenom.ffwll.local ([2a02:168:57f4:0:efd0:b9e5:5ae6:c2fa]) by smtp.gmail.com with ESMTPSA id 5sm2288561wrb.113.2022.01.27.03.31.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 27 Jan 2022 03:31:46 -0800 (PST) Date: Thu, 27 Jan 2022 12:31:44 +0100 From: Daniel Vetter To: Javier Martinez Canillas Cc: Thomas Zimmermann , linux-kernel@vger.kernel.org, Jonathan Corbet , David Airlie , Daniel Vetter , dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, Laurent Pinchart , Pekka Paalanen Subject: Re: [PATCH] drm/doc: Add section in the introduction page about learning material Message-ID: Mail-Followup-To: Javier Martinez Canillas , Thomas Zimmermann , linux-kernel@vger.kernel.org, Jonathan Corbet , David Airlie , dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, Laurent Pinchart , Pekka Paalanen References: <20220127082058.434421-1-javierm@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: Linux phenom 5.10.0-8-amd64 Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Thu, Jan 27, 2022 at 11:50:30AM +0100, Javier Martinez Canillas wrote: > Hello Thomas, > > On 1/27/22 10:18, Thomas Zimmermann wrote: > > Hi Javier, > > > > thanks for this patch. > > > > Acked-by: Thomas Zimmermann > > > > Thanks! > > > Find some ideas for consideration below. > > > > [snip] > > >> + > >> +Learning material > >> +================= > > > > Maybe 'External References'. > > > > Agreed, I'll change it. > > >> + > >> +Since the Linux DRM layer supports complex graphics devices, it can be quite > >> +overwhelming for newcomers to get familiar with all the needed concepts and > >> +learn the subsystem's internals. > > > > It sounds a bit intimdating to me. Can we give it a positive spin? > > > > Pekka also had reservations about this paragraph, so I think that will just > drop it. The goal of having this section was to ease the learning curve but > the way I worded it may reinforce the perception that DRM is hard to learn. > > > IMHO we could add a separate section that talks about complexity and > > provides guidelines about how to deal with it: trivial HW? use simple > > pipe; dedicated VRAM? try TTM; awkward color formats? see > > drm_format_helper.c > > > > Indeed. And we can add such section as a follow-up. Maybe referring to some > of the drivers in drivers/gpu/drm/tiny. Do we have a talk anywhere for tiny? Otherwise I think it'd be good to just add a paragraph about "hey tiny exists" and maybe link to fbdev helpers and simple pipe helpers to get people started with the right entry points for simple drivers. And make it clear that the above pile of links is more for general overview and if you don't yet know what exactly it is you need. Also I guess for this year's xdc I really need to volunteer someone to do a drm/tiny intro :-) Cheers, Daniel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch