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 X-Spam-Level: X-Spam-Status: No, score=-9.7 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id B01B9C4363D for ; Fri, 2 Oct 2020 18:09:17 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 71DF9208A9 for ; Fri, 2 Oct 2020 18:09:17 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2388362AbgJBSJQ (ORCPT ); Fri, 2 Oct 2020 14:09:16 -0400 Received: from vps0.lunn.ch ([185.16.172.187]:40936 "EHLO vps0.lunn.ch" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726224AbgJBSJP (ORCPT ); Fri, 2 Oct 2020 14:09:15 -0400 Received: from andrew by vps0.lunn.ch with local (Exim 4.94) (envelope-from ) id 1kOPUQ-00HHTe-FJ; Fri, 02 Oct 2020 20:09:06 +0200 Date: Fri, 2 Oct 2020 20:09:06 +0200 From: Andrew Lunn To: Jarod Wilson Cc: linux-kernel@vger.kernel.org, Jay Vosburgh , Veaceslav Falico , Andy Gospodarek , "David S. Miller" , Jakub Kicinski , Thomas Davis , netdev@vger.kernel.org Subject: Re: [PATCH net-next v2 5/6] bonding: update Documentation for port/bond terminology Message-ID: <20201002180906.GG3996795@lunn.ch> References: <20201002174001.3012643-1-jarod@redhat.com> <20201002174001.3012643-6-jarod@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20201002174001.3012643-6-jarod@redhat.com> Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, Oct 02, 2020 at 01:40:00PM -0400, Jarod Wilson wrote: > Point users to the new interface names instead of the old ones, where > appropriate. Userspace bits referenced still include use of master/slave, > but those can't be altered until userspace changes too, ideally after > these changes propagate to the community at large. > > Cc: Jay Vosburgh > Cc: Veaceslav Falico > Cc: Andy Gospodarek > Cc: "David S. Miller" > Cc: Jakub Kicinski > Cc: Thomas Davis > Cc: netdev@vger.kernel.org > Signed-off-by: Jarod Wilson > --- > Documentation/networking/bonding.rst | 440 +++++++++++++-------------- > 1 file changed, 220 insertions(+), 220 deletions(-) > > diff --git a/Documentation/networking/bonding.rst b/Documentation/networking/bonding.rst > index adc314639085..f4c4f0fae83b 100644 > --- a/Documentation/networking/bonding.rst > +++ b/Documentation/networking/bonding.rst > @@ -167,22 +167,22 @@ or, for backwards compatibility, the option value. E.g., > > The parameters are as follows: > > -active_slave > +active_port Hi Jarod It is going to take quite a while before all distributions user space gets updated. So todays API is going to live on for a few years. People are going to be search the documentation using the terms their user space uses, which are going to be todays terms, not the new ones you are introducing here. For that to work, i think you are going to have to introduce a table listing todays names and the new names you are adding, so search engines have some chance of finding this document, and readers have some clue as to how to translate from what their user space is using to the terms used in the document. Andrew