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 79C40C433FE for ; Mon, 7 Nov 2022 18:35:44 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232575AbiKGSfn (ORCPT ); Mon, 7 Nov 2022 13:35:43 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49338 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232471AbiKGSfm (ORCPT ); Mon, 7 Nov 2022 13:35:42 -0500 Received: from mail-lf1-x12b.google.com (mail-lf1-x12b.google.com [IPv6:2a00:1450:4864:20::12b]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 852A620F5D for ; Mon, 7 Nov 2022 10:35:41 -0800 (PST) Received: by mail-lf1-x12b.google.com with SMTP id r12so17991846lfp.1 for ; Mon, 07 Nov 2022 10:35:41 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=RZto2aI8Bptli2OzTKbCF8aaAGorStB0N8MSB1xDDtE=; b=vo5nLgHJwfnXEhjUBrU1bPOwdaFEjM909+M2qoa53AjbBjcM3hNZqMa4pZzsuCQRn0 lpPDAJnxdGAijHfUaO4MdbZe4RjB65J7KstdKxwI6d0f8BLN822lpu8f8Wc8TuJClkKN ZM9eJuggIQbYxLVe77V7d3dGfkJih4Yo4HoeUA5JtntxU5R0KyJbIJnhQ5nOBYCh0Mnr eQcH3mcm+IGiCba6xHn9au9243J9KLjzFhg9TBAUT76iv1KbLNYW+yMMrjdHST1AD7NQ LSJFvlneJpLNT3t2mc0UA85cSd1YTHdFuOg2ZYtRlHQ/kkiQOWjtN+E6UePW9qbg/ZXZ RCWg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=RZto2aI8Bptli2OzTKbCF8aaAGorStB0N8MSB1xDDtE=; b=WzXDexA4peR++GkbYJrTo+hIYNXpyGoxX/Kj96BES2rlpGhl43PuVryThruJ+Ife85 vwuTz1/YRx7q8g46z+QOVW+GN62yLFLI3TZejMnHA7CeJSARxZkF5BsoyBD87jFI86Fb uHqzDoobwN+WT52Xv3VYlXVowTpXYKxVYfMMp3oun3RmXpyZGTQwPw99r00lyhiusqmZ v8wnWlS9jyqVK2c/45GLvwazdMUEstwyg73Ws7Ebi85kzRn0L5X3F8S3wZpSvViTPKi0 rvRJj+8A3TQXMlKxvsDunRPL4wGeXPR/VYJyZ+RymTrrKTxznwLr1bfxv4EG2/uXg8Dr cfLg== X-Gm-Message-State: ACrzQf1u4k+IjFUzDST+dc9VvPwNHo57RHQoa8hdk2PlQ53LbRoSDqJ/ mSJYLtl6ynOtjG7uEwqGgZ/PGQ== X-Google-Smtp-Source: AMsMyM6ioglBiZGtDLKRsAr68YwkWzhXxrEcAKOa49F6LtuCSk/ZFcxVyr3OS6Jtu4/aUqvZZJBsLQ== X-Received: by 2002:ac2:5221:0:b0:4a4:5af7:8ad5 with SMTP id i1-20020ac25221000000b004a45af78ad5mr17457353lfl.388.1667846139899; Mon, 07 Nov 2022 10:35:39 -0800 (PST) Received: from [192.168.0.20] (088156142199.dynamic-2-waw-k-3-2-0.vectranet.pl. [88.156.142.199]) by smtp.gmail.com with ESMTPSA id j23-20020a056512345700b00492d064e8f8sm1371621lfr.263.2022.11.07.10.35.38 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 07 Nov 2022 10:35:39 -0800 (PST) Message-ID: Date: Mon, 7 Nov 2022 19:35:38 +0100 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.4.2 Subject: Re: [PATCH] dt-bindings: examples: add a list of templates and solutions Content-Language: en-US To: Rob Herring Cc: Krzysztof Kozlowski , Matthias Brugger , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org References: <20221028233701.572280-1-krzysztof.kozlowski@linaro.org> <20221101130720.GA963805-robh@kernel.org> <34f40c1c-f933-cee6-f022-14c37650dc3a@linaro.org> <20221104214744.GA2878314-robh@kernel.org> From: Krzysztof Kozlowski In-Reply-To: <20221104214744.GA2878314-robh@kernel.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org On 04/11/2022 22:47, Rob Herring wrote: >>>> +7. Phandle to syscon with offset: >>>> + Documentation/devicetree/bindings/soc/samsung/exynos-usi.yaml >>>> + Line: 42 >>>> + >>>> +8. Variable length of array (e.g. clocks and clock-names) but narrowed to >>>> + specific variant: >>>> + Documentation/devicetree/bindings/clock/qcom,mmcc.yaml >>>> + Lines: 33 and 71 >>> >>> It seems like some of these that are just a single property we could add >>> to example-schema.yaml. >> >> I am afraid the example-schema will grow too big for folks to look into. >> It's already quite complicated, with explanations of the dtschema >> behavior itself. > > How about splitting up the top-level descriptions and property examples? You mean splitting up to separate YAML files? I guess this could work and still be concise - few examples showing different concepts. > >> How about then RST file with small code snippets? > > Then they don't validate. > >> >>> Also, perhaps a reference to this from writing-schema.rst. >> >> I can do this as well. >> >> The problem with my approach above (and adding these to writing-schema) >> is that examples above can change, lines can be inadequate. > > I just meant a link in writing-schema.rst to this doc. We already have > that for example-schema.yaml. Best regards, Krzysztof