From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 587B042369; Wed, 11 Oct 2023 20:26:47 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id DC418400EF; Wed, 11 Oct 2023 20:26:46 +0200 (CEST) Received: from mail-ed1-f53.google.com (mail-ed1-f53.google.com [209.85.208.53]) by mails.dpdk.org (Postfix) with ESMTP id C845D400D7 for ; Wed, 11 Oct 2023 20:26:45 +0200 (CEST) Received: by mail-ed1-f53.google.com with SMTP id 4fb4d7f45d1cf-5334f8a40e2so63649a12.1 for ; Wed, 11 Oct 2023 11:26:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=youngcopy-com.20230601.gappssmtp.com; s=20230601; t=1697048805; x=1697653605; darn=dpdk.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=S3minxZQF2pgEF+U4uX3IAi7Lb7Wu6B63/E3qdgSTtM=; b=Z+B2oZBXq4vd15bw+mFtv3iI0W/VYgHCioDR9gSTl5UdNZNdWC2GujQozSohGMKpCQ E/suxuHAY+mIIL7BeS0CY+uGpf2nnzgUz26TTLfvIiZMxAlOUEhJ4toCTFAqSQM5FX/v L/DGPshi+i0Jd1VbP+vSSc/rsk0B5UwuuwTRTWPRTb/S3tXDsUw25/dEvk+AgggM7nQG 2/pLi8uwCjt7pCpIPxkI7Ka653cM0GCaDcN4EvNDw2gzwdz9MAIpjOC0KwjHfGZRAoOC BDiFkS/iTPCXEIUSN8JKks2h+001h4UncGBAGjTHJXoPlHf18hsO6Xr1A5FgbGlpytNo 48IQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697048805; x=1697653605; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=S3minxZQF2pgEF+U4uX3IAi7Lb7Wu6B63/E3qdgSTtM=; b=axbSA+uhnOlvaKpTgkWupp2uEZmPE8P3SMWcMniM6MaUQMsA/KHl89rFUTwnQqZdDe 7zsV8fbeB1BcjAsCROZjwZJy2YB5TSik+DArIpXfaxZMii1Bco5ts7YLfx+V67JdWVZa n4SDq9HU9q4RSBuODd5fYbC9fHs6dDCTbb0SrYmPNkMRS9QY8izDOwo4BV4+UBTE/o7v sxn9ZJfWntuvjszx10J6MUCURWeUqqBv0mcYJxaTMYHzsarCrHxZyKDqflF88nkchsfR pdySqT00VY7h948PccTjJZ1wEQbbZ55gKyK+lefyDrs6NhGYnAu/dAPfc0LXPy03rxL1 4TEA== X-Gm-Message-State: AOJu0YzzOJhdgqyQu345HUYyaWcHYibzy7uXciwVZVhTthUyVZNyyigE ra2ScQpVbYdB1X/2nMwGReHcgmLkjzTRMTrDvrYVsA== X-Google-Smtp-Source: AGHT+IFY09TXoSspkpVa9L8Lvus4ksR8EHqMDXB9A+996WtSjt6TAG+LnSfbRrn2v/C2Fyib+Ee3J6wjXI15gow2NlM= X-Received: by 2002:a17:906:2c9:b0:9a6:5340:c331 with SMTP id 9-20020a17090602c900b009a65340c331mr18418812ejk.2.1697048805235; Wed, 11 Oct 2023 11:26:45 -0700 (PDT) MIME-Version: 1.0 References: <20230920154817.617-1-dave@youngcopy.com> <20230920154817.617-2-dave@youngcopy.com> <380c6465-e582-4d88-8eef-58de66fa1dce@amd.com> In-Reply-To: <380c6465-e582-4d88-8eef-58de66fa1dce@amd.com> From: Dave Young Date: Wed, 11 Oct 2023 14:26:33 -0400 Message-ID: Subject: Re: [PATCH 1/6] Section 1: Introduction To: Ferruh Yigit Cc: dev@dpdk.org, Bruce Richardson Content-Type: multipart/alternative; boundary="00000000000033f167060774f71e" X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org --00000000000033f167060774f71e Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Thank you for the feedback. I agree with the suggested changes to remove "unified" and the last paragraph. These changes have been made locally. I plan to send updated versions of all patches in this series at the same time, so you can expect to see these adjustments in the next version. Thanks! David Young Professional Copywriter/Technical Writer Young Copy +1 (678) 500-9550 https://www.youngcopy.com On Mon, Sep 25, 2023 at 7:30=E2=80=AFAM Ferruh Yigit = wrote: > On 9/20/2023 4:48 PM, David Young wrote: > > --- > > doc/guides/getting_started_guide/intro.rst | 16 ++++++++++++++++ > > 1 file changed, 16 insertions(+) > > create mode 100644 doc/guides/getting_started_guide/intro.rst > > > > diff --git a/doc/guides/getting_started_guide/intro.rst > b/doc/guides/getting_started_guide/intro.rst > > new file mode 100644 > > index 0000000000..88bdd48849 > > --- /dev/null > > +++ b/doc/guides/getting_started_guide/intro.rst > > @@ -0,0 +1,16 @@ > > +.. SPDX-License-Identifier: BSD-3-Clause > > + Copyright(c) 2010-2014 Intel Corporation. > > + > > +Introduction > > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > + > > +Welcome to the unified getting started guide for the Data Plane > Development Kit (DPDK) covering Linux, FreeBSD, and Windows. DPDK is a se= t > of libraries and > > > > 'unified' makes sense only with the context of this effort, for anyone > who is reading this for the first time it may not mean much, I suggest > just drop it: "Welcome to the getting started guide for ..." > > > > +drivers that accelerate packet processing and allow the user to create > high-performance > > +networking applications. > > + > > +The guide is structured to provide basic step-by-step instructions wit= h > OS-specific instructions for each operating system where necessary. > > +By the end of this guide, you should have a solid understanding of how > to implement and > > +use DPDK in your networking projects, regardless of the operating > system you are using. > > + > > +We hope this guide serves as a valuable resource as you explore the > powerful > > +capabilities of DPDK. > > \ No newline at end of file > > Last paragraph feels like marketing text :), I would be OK without it, > but this is personal preference. > > --00000000000033f167060774f71e Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Thank you for the feedback. I agree with the suggeste= d changes to remove "unified" and the last paragraph. These chang= es have been made locally. I plan to send updated versions of all patches i= n this series at the same time, so you can expect to see these adjustments = in the next version.

Thanks!
David Young
Professional Copywriter/= Technical Writer
Young Copy
+1 (678) 500-9550
https://www.young= copy.com


On Mon, Sep 2= 5, 2023 at 7:30=E2=80=AFAM Ferruh Yigit <ferruh.yigit@amd.com> wrote:
On 9/20/2023 4:48 PM, David Young wrote:
> ---
>=C2=A0 doc/guides/getting_started_guide/intro.rst | 16 ++++++++++++++++=
>=C2=A0 1 file changed, 16 insertions(+)
>=C2=A0 create mode 100644 doc/guides/getting_started_guide/intro.rst >
> diff --git a/doc/guides/getting_started_guide/intro.rst b/doc/guides/g= etting_started_guide/intro.rst
> new file mode 100644
> index 0000000000..88bdd48849
> --- /dev/null
> +++ b/doc/guides/getting_started_guide/intro.rst
> @@ -0,0 +1,16 @@
> +..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
> +=C2=A0 =C2=A0 Copyright(c) 2010-2014 Intel Corporation.
> +
> +Introduction
> +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
> +
> +Welcome to the unified getting started guide for the Data Plane Devel= opment Kit (DPDK) covering Linux, FreeBSD, and Windows. DPDK is a set of li= braries and
>

'unified' makes sense only with the context of this effort, for any= one
who is reading this for the first time it may not mean much, I suggest
just drop it: "Welcome to the getting started guide for ..."


> +drivers that accelerate packet processing and allow the user to creat= e high-performance
> +networking applications.
> +
> +The guide is structured to provide basic step-by-step instructions wi= th OS-specific instructions for each operating system where necessary.
> +By the end of this guide, you should have a solid understanding of ho= w to implement and
> +use DPDK in your networking projects, regardless of the operating sys= tem you are using.
> +
> +We hope this guide serves as a valuable resource as you explore the p= owerful
> +capabilities of DPDK.
> \ No newline at end of file

Last paragraph feels like marketing text :), I would be OK without it,
but this is personal preference.

--00000000000033f167060774f71e--