Received: by 2002:a05:6358:d09b:b0:dc:cd0c:909e with SMTP id jc27csp946338rwb; Wed, 7 Dec 2022 06:59:36 -0800 (PST) X-Google-Smtp-Source: AA0mqf6+d/mgZEdel+y03URNdxCHElAuCS9ZveNCMd7uy7yNmr8KaBgaWoiI64ObGUaMewMuDMJz X-Received: by 2002:a17:906:81c9:b0:7c0:dcb3:718b with SMTP id e9-20020a17090681c900b007c0dcb3718bmr14493752ejx.711.1670425176577; Wed, 07 Dec 2022 06:59:36 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1670425176; cv=none; d=google.com; s=arc-20160816; b=BsquHSW5mFEiWiuqz67LnPG7dYHlJK3RZWJWNVQGFxBXQDaV9Xsw3qt65OBkiwMYNG 77HkbNAc5EB+Sch0zKqiE1qojHFeMaE0pHFj9ehn0VtmoW8H/kw1LVWXIwJZDCmfHKk9 CHEuZbXWojdvnIXYOqiVhJhgI3nAXR//WWOgZc5VqLa6pQvyhpFL+piBMfNKGFv7Byeu AquNRz/QCVG2v9CE2rfFuZJgeWimdqIKabTGxm3cWQTsCFoIu0zL99ZOvl4GxFxwGUur UkSnHBM2LmMpPWTTR90xv8gfEHOVNpmqWMp0fWp2YK80HjZpnviBMBeZMa4U9WdCWJMI NBRQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:message-id:date:references :organization:in-reply-to:subject:cc:to:from:dkim-signature; bh=g9HYnGCmMnYQHFsTw8DNhJPz6uDLSj0eB60dW9beJsU=; b=DGWvYUiciJAl+ROxgR9dQHqWAYKHMS6JesP85RdwqjpTsWt/ANicumsrPII3UZe1H5 RkcMT554wHLpG70uByP/pFYWs0dJsbeFYTAHD3QTqzHhovC9x4Od0bCqXTK4bBP1KcvB Jh+2Ph1VCLll+yNhiRx41RkgFyb86zRrFIk+fapMxTyx34lR4HdKmPBx//bpf9UYxqnN s4HqRoUAwVJqJ3KHBRJ0ajX61ZFbjxwFoImyiOhG2a0Edyu9PZfrFVChHjEmXXeIZmOj CnNaSpbMCuQvfvUpzMMpYEM/Lk8J2JfIYZGDT1tsKCx4gWCClMlbLtOWK9iveA88dBDz hzmQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=kXZP52tH; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id hb36-20020a170907162400b0078a3ef9f092si9351718ejc.998.2022.12.07.06.59.18; Wed, 07 Dec 2022 06:59:36 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=kXZP52tH; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229885AbiLGOQD (ORCPT + 76 others); Wed, 7 Dec 2022 09:16:03 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42860 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229480AbiLGOQB (ORCPT ); Wed, 7 Dec 2022 09:16:01 -0500 Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7B44A4A58E; Wed, 7 Dec 2022 06:16:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1670422560; x=1701958560; h=from:to:cc:subject:in-reply-to:references:date: message-id:mime-version; bh=PP7KOTPt4ERsWQH2CfJ+vJdbgsy5iXmqVONYHIHapR4=; b=kXZP52tHgBKlRbUjf4cjKgOnQOwPjTpNR2WwLI4f5WkarHsfbCwS2ck/ 77uI5sJzvgVvlKDy+19JAbgPIinlG+EujQoB9rJVsBJf2peG2A9hP3c3C Nc/Q/mStPnVlUXk79OnicIORcl5lT7DswP/8Y3k/uNtq8ouJ6MuKaqpsn FdqMLbZfJKxCeYM897PM8PsxL6x9++5vszfGsEnMJvZrGbMl8G0eEalZ5 mhxsxL6shvgP8T/bbm4Fjp5Oei0PSJQEAvbqIRRN85/e4h1Z+aXtJ/N8y b9U/p5uZ+dS23Oc9yaya/Cya+lyFP2gs7vb+gvfau7+0xw7rHLCjfwx8V w==; X-IronPort-AV: E=McAfee;i="6500,9779,10553"; a="318756464" X-IronPort-AV: E=Sophos;i="5.96,225,1665471600"; d="scan'208";a="318756464" Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by orsmga103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 07 Dec 2022 06:15:42 -0800 X-IronPort-AV: E=McAfee;i="6500,9779,10553"; a="753111853" X-IronPort-AV: E=Sophos;i="5.96,225,1665471600"; d="scan'208";a="753111853" Received: from fbackhou-mobl1.ger.corp.intel.com (HELO localhost) ([10.252.36.192]) by fmsmga002-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 07 Dec 2022 06:15:39 -0800 From: Jani Nikula To: Carlos Bilbao , corbet@lwn.net, akiyks@gmail.com, ojeda@kernel.org Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, bilbao@vt.edu, konstantin@linuxfoundation.org Subject: Re: [PATCH v3 1/2] docs: Move rustdoc output, cross-reference it In-Reply-To: <5887a9cd-b48e-e2af-7639-3f9ff53fcd8a@amd.com> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <20221201204814.2141401-1-carlos.bilbao@amd.com> <20221206153151.771038-1-carlos.bilbao@amd.com> <20221206153151.771038-2-carlos.bilbao@amd.com> <87359r39gg.fsf@intel.com> <5887a9cd-b48e-e2af-7639-3f9ff53fcd8a@amd.com> Date: Wed, 07 Dec 2022 16:15:36 +0200 Message-ID: <87lenj1erb.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Status: No, score=-4.3 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Wed, 07 Dec 2022, Carlos Bilbao wrote: > On 12/7/22 2:27 AM, Jani Nikula wrote: >> Also, please don't use "here" as the link text. > > Why not? It's considered bad style, see e.g. [1] or [2] or the plethora of results you get if you search for "here as the link text". The link text should describe what's at the destination. BR, Jani. [1] https://ux.stackexchange.com/questions/12100/why-shouldnt-we-use-words-such-as-here-and-this-in-textlinks [2] https://www.w3.org/QA/Tips/noClickHere -- Jani Nikula, Intel Open Source Graphics Center