[website] _content/doc: change generics and fuzz tutorials from beta

2 views
Skip to first unread message

Eli Bendersky‎ (Gerrit)

unread,
Mar 15, 2022, 8:14:56 PM3/15/22
to goph...@pubsubhelper.golang.org, golang-co...@googlegroups.com

Eli Bendersky‎ has uploaded this change for review.

View Change

_content/doc: change generics and fuzz tutorials from beta

Go 1.18 is released; these tutorials are now out of beta as well.

Fixes golang/go#51688

Change-Id: I5ded6c75f3131c97e3d2104146e0dff98dd7b1b0
---
M _content/doc/index.html
M _content/doc/tutorial/fuzz.md
M _content/doc/tutorial/generics.md
3 files changed, 19 insertions(+), 91 deletions(-)

diff --git a/_content/doc/index.html b/_content/doc/index.html
index 6aaa239..bd872b6 100644
--- a/_content/doc/index.html
+++ b/_content/doc/index.html
@@ -49,12 +49,12 @@
Introduces the basics of writing a RESTful web service API with Go and the Gin Web Framework.
</p>

-<h3 id="generics-tutorial"><a href="/doc/tutorial/generics.html">Tutorial: Getting started with generics (beta)</a></h3>
+<h3 id="generics-tutorial"><a href="/doc/tutorial/generics.html">Tutorial: Getting started with generics</a></h3>
<p>
With generics, you can declare and use functions or types that are written to work with any of a set of types provided by calling code.
</p>

-<h3 id="fuzz-tutorial"><a href="/doc/tutorial/fuzz.html">Tutorial: Getting started with fuzzing (beta)</a></h3>
+<h3 id="fuzz-tutorial"><a href="/doc/tutorial/fuzz.html">Tutorial: Getting started with fuzzing</a></h3>
<p>
Fuzzing can generate inputs to your tests that can catch edge cases and security issues that you may have missed.
</p>
diff --git a/_content/doc/tutorial/fuzz.md b/_content/doc/tutorial/fuzz.md
index 6d07cf6..aebb4b4 100644
--- a/_content/doc/tutorial/fuzz.md
+++ b/_content/doc/tutorial/fuzz.md
@@ -3,8 +3,6 @@
"HideTOC": true
}-->

-> **Note: This is beta content.**
-
This tutorial introduces the basics of fuzzing in Go. With fuzzing, random data
is run against your test in an attempt to find vulnerabilities or crash-causing
inputs. Some examples of vulnerabilities that can be found by fuzzing are SQL
@@ -33,55 +31,14 @@

## Prerequisites

-- **An installation of Go 1.18 Beta 1 or later.** For installation instructions,
- see [Installing and using the beta](#installing_beta).
+- **An installation of Go 1.18 later.** For installation instructions, see
+ [Installing Go](/doc/install).
- **A tool to edit your code.** Any text editor you have will work fine.
- **A command terminal.** Go works well using any terminal on Linux and Mac, and
on PowerShell or cmd in Windows.
- **An environment that supports fuzzing.** Go fuzzing with coverage
instrumentation is only available on AMD64 and ARM64 architectures currently.

-<!-- TODO: Remove this section after release. -->
-
-### Installing and using the beta {#installing_beta}
-
-This tutorial requires the fuzzing feature available in Beta 1. To install the
-beta, following these steps:
-
-1. Run the following command to install the beta.
-
- ```
- $ go install golang.org/dl/go1.18beta1@latest
- ```
-
-2. Run the following command to download updates.
-
- ```
- $ go1.18beta1 download
- ```
-
-3. Run `go` commands using the beta instead of a released version of Go (if you
- have one).
-
- You can run commands with the beta either by using the beta name or by
- aliasing the beta to another name.
-
- - Using the beta name, you can run commands by invoking `go1.18beta1` instead
- of `go`:
-
- ```
- $ go1.18beta1 version
- ```
-
- - By aliasing the beta name to another name, you can simplify the command:
-
- ```
- $ alias go=go1.18beta1
- $ go version
- ```
-
- Commands in this tutorial will assume you have aliased the beta name.
-
## Create a folder for your code {#create_folder}

To begin, create a folder for the code you’ll write.
diff --git a/_content/doc/tutorial/generics.md b/_content/doc/tutorial/generics.md
index 95c6583..53754a9 100644
--- a/_content/doc/tutorial/generics.md
+++ b/_content/doc/tutorial/generics.md
@@ -2,8 +2,6 @@
"Title": "Tutorial: Getting started with generics"
}-->

-> **Note: This is beta content.**
-
This tutorial introduces the basics of generics in Go. With generics, you can
declare and use functions or types that are written to work with any of a set
of types provided by calling code.
@@ -27,52 +25,12 @@

## Prerequisites

-* **An installation of Go 1.18 Beta 1 or later.** For installation
- instructions, see [Installing and using the beta](#installing_beta).
+* **An installation of Go 1.18 later.** For installation instructions, see
+ [Installing Go](/doc/install).
* **A tool to edit your code.** Any text editor you have will work fine.
* **A command terminal.** Go works well using any terminal on Linux and Mac,
and on PowerShell or cmd in Windows.

-<!-- TODO: Remove this section after release. -->
-#### Installing and using the beta {#installing_beta}
-
-This tutorial requires the generics feature available in Beta 1. To install
-the beta, following these steps:
-
-1. Run the following command to install the beta.
-
- ```
- $ go install golang.org/dl/go1.18beta1@latest
- ```
-
-2. Run the following command to download updates.
-
- ```
- $ go1.18beta1 download
- ```
-
-3. Run `go` commands using the beta instead of a released version of Go (if you
- have one).
-
- You can run commands with the beta either by using the beta name or by
- aliasing the beta to another name.
-
- * Using the beta name, you can run commands by invoking `go1.18beta1`
- instead of `go`:
-
- ```
- $ go1.18beta1 version
- ```
-
- * By aliasing the beta name to another name, you can simplify the command:
-
- ```
- $ alias go=go1.18beta1
- $ go version
- ```
-
-Commands in this tutorial will assume you have aliased the beta name.
-
## Create a folder for your code {#create_folder}

To begin, create a folder for the code you’ll write.

To view, visit change 393215. To unsubscribe, or for help writing mail filters, visit settings.

Gerrit-Project: website
Gerrit-Branch: master
Gerrit-Change-Id: I5ded6c75f3131c97e3d2104146e0dff98dd7b1b0
Gerrit-Change-Number: 393215
Gerrit-PatchSet: 1
Gerrit-Owner: Eli Bendersky‎ <eli...@golang.org>
Gerrit-MessageType: newchange

Dmitri Shuralyov (Gerrit)

unread,
Mar 15, 2022, 10:23:27 PM3/15/22
to Eli Bendersky‎, goph...@pubsubhelper.golang.org, Dmitri Shuralyov, Ian Lance Taylor, golang-co...@googlegroups.com

Attention is currently required from: Eli Bendersky‎, Ian Lance Taylor.

Patch set 1:Run-TryBot +1

View Change

3 comments:

To view, visit change 393215. To unsubscribe, or for help writing mail filters, visit settings.

Gerrit-Project: website
Gerrit-Branch: master
Gerrit-Change-Id: I5ded6c75f3131c97e3d2104146e0dff98dd7b1b0
Gerrit-Change-Number: 393215
Gerrit-PatchSet: 1
Gerrit-Owner: Eli Bendersky‎ <eli...@golang.org>
Gerrit-Reviewer: Dmitri Shuralyov <dmit...@golang.org>
Gerrit-Reviewer: Ian Lance Taylor <ia...@golang.org>
Gerrit-Attention: Eli Bendersky‎ <eli...@golang.org>
Gerrit-Attention: Ian Lance Taylor <ia...@golang.org>
Gerrit-Comment-Date: Wed, 16 Mar 2022 02:23:22 +0000
Gerrit-HasComments: Yes
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment

Dmitri Shuralyov (Gerrit)

unread,
Mar 15, 2022, 10:23:39 PM3/15/22
to Eli Bendersky‎, goph...@pubsubhelper.golang.org, Gopher Robot, Dmitri Shuralyov, Ian Lance Taylor, golang-co...@googlegroups.com

Attention is currently required from: Eli Bendersky‎, Ian Lance Taylor.

Patch set 1:Code-Review +2

View Change

    To view, visit change 393215. To unsubscribe, or for help writing mail filters, visit settings.

    Gerrit-Project: website
    Gerrit-Branch: master
    Gerrit-Change-Id: I5ded6c75f3131c97e3d2104146e0dff98dd7b1b0
    Gerrit-Change-Number: 393215
    Gerrit-PatchSet: 1
    Gerrit-Owner: Eli Bendersky‎ <eli...@golang.org>
    Gerrit-Reviewer: Dmitri Shuralyov <dmit...@golang.org>
    Gerrit-Reviewer: Dmitri Shuralyov <dmit...@google.com>
    Gerrit-Reviewer: Ian Lance Taylor <ia...@golang.org>
    Gerrit-CC: Gopher Robot <go...@golang.org>
    Gerrit-Attention: Eli Bendersky‎ <eli...@golang.org>
    Gerrit-Attention: Ian Lance Taylor <ia...@golang.org>
    Gerrit-Comment-Date: Wed, 16 Mar 2022 02:23:34 +0000
    Gerrit-HasComments: No
    Gerrit-Has-Labels: Yes
    Gerrit-MessageType: comment

    Eli Bendersky‎ (Gerrit)

    unread,
    Mar 15, 2022, 10:49:19 PM3/15/22
    to goph...@pubsubhelper.golang.org, golang-co...@googlegroups.com

    Attention is currently required from: Eli Bendersky‎, Ian Lance Taylor.

    Eli Bendersky‎ uploaded patch set #2 to this change.

    View Change

    _content/doc: change generics and fuzz tutorials from beta

    Go 1.18 is released; these tutorials are now out of beta as well.

    Fixes golang/go#51688

    Change-Id: I5ded6c75f3131c97e3d2104146e0dff98dd7b1b0
    ---
    M _content/doc/index.html
    M _content/doc/tutorial/fuzz.md
    M _content/doc/tutorial/generics.md
    3 files changed, 19 insertions(+), 91 deletions(-)

    To view, visit change 393215. To unsubscribe, or for help writing mail filters, visit settings.

    Gerrit-Project: website
    Gerrit-Branch: master
    Gerrit-Change-Id: I5ded6c75f3131c97e3d2104146e0dff98dd7b1b0
    Gerrit-Change-Number: 393215
    Gerrit-PatchSet: 2
    Gerrit-Owner: Eli Bendersky‎ <eli...@golang.org>
    Gerrit-Reviewer: Dmitri Shuralyov <dmit...@golang.org>
    Gerrit-Reviewer: Dmitri Shuralyov <dmit...@google.com>
    Gerrit-Reviewer: Gopher Robot <go...@golang.org>
    Gerrit-Reviewer: Ian Lance Taylor <ia...@golang.org>
    Gerrit-Attention: Eli Bendersky‎ <eli...@golang.org>
    Gerrit-Attention: Ian Lance Taylor <ia...@golang.org>
    Gerrit-MessageType: newpatchset

    Eli Bendersky‎ (Gerrit)

    unread,
    Mar 15, 2022, 10:49:31 PM3/15/22
    to goph...@pubsubhelper.golang.org, Gopher Robot, Dmitri Shuralyov, Dmitri Shuralyov, Ian Lance Taylor, golang-co...@googlegroups.com

    Attention is currently required from: Dmitri Shuralyov, Ian Lance Taylor.

    View Change

    2 comments:

    • File _content/doc/tutorial/fuzz.md:

      • Done

    • File _content/doc/tutorial/generics.md:

      • Done

    To view, visit change 393215. To unsubscribe, or for help writing mail filters, visit settings.

    Gerrit-Project: website
    Gerrit-Branch: master
    Gerrit-Change-Id: I5ded6c75f3131c97e3d2104146e0dff98dd7b1b0
    Gerrit-Change-Number: 393215
    Gerrit-PatchSet: 1
    Gerrit-Owner: Eli Bendersky‎ <eli...@golang.org>
    Gerrit-Reviewer: Dmitri Shuralyov <dmit...@golang.org>
    Gerrit-Reviewer: Dmitri Shuralyov <dmit...@google.com>
    Gerrit-Reviewer: Gopher Robot <go...@golang.org>
    Gerrit-Reviewer: Ian Lance Taylor <ia...@golang.org>
    Gerrit-Attention: Dmitri Shuralyov <dmit...@golang.org>
    Gerrit-Attention: Ian Lance Taylor <ia...@golang.org>
    Gerrit-Comment-Date: Wed, 16 Mar 2022 02:49:28 +0000
    Gerrit-HasComments: Yes
    Gerrit-Has-Labels: No
    Comment-In-Reply-To: Dmitri Shuralyov <dmit...@golang.org>
    Gerrit-MessageType: comment

    Eli Bendersky (Gerrit)

    unread,
    Mar 16, 2022, 10:24:33 AM3/16/22
    to Eli Bendersky‎, goph...@pubsubhelper.golang.org, Gopher Robot, Dmitri Shuralyov, Dmitri Shuralyov, Ian Lance Taylor, golang-co...@googlegroups.com

    Attention is currently required from: Eli Bendersky‎, Ian Lance Taylor.

    Patch set 2:Trust +1

    View Change

      To view, visit change 393215. To unsubscribe, or for help writing mail filters, visit settings.

      Gerrit-Project: website
      Gerrit-Branch: master
      Gerrit-Change-Id: I5ded6c75f3131c97e3d2104146e0dff98dd7b1b0
      Gerrit-Change-Number: 393215
      Gerrit-PatchSet: 2
      Gerrit-Owner: Eli Bendersky‎ <eli...@golang.org>
      Gerrit-Reviewer: Dmitri Shuralyov <dmit...@golang.org>
      Gerrit-Reviewer: Dmitri Shuralyov <dmit...@google.com>
      Gerrit-Reviewer: Eli Bendersky <eli...@google.com>
      Gerrit-Reviewer: Gopher Robot <go...@golang.org>
      Gerrit-Reviewer: Ian Lance Taylor <ia...@golang.org>
      Gerrit-Attention: Eli Bendersky‎ <eli...@golang.org>
      Gerrit-Attention: Ian Lance Taylor <ia...@golang.org>
      Gerrit-Comment-Date: Wed, 16 Mar 2022 14:24:27 +0000

      Eli Bendersky (Gerrit)

      unread,
      Mar 16, 2022, 10:24:44 AM3/16/22
      to Eli Bendersky‎, goph...@pubsubhelper.golang.org, golang-...@googlegroups.com, Gopher Robot, Dmitri Shuralyov, Dmitri Shuralyov, Ian Lance Taylor, golang-co...@googlegroups.com

      Eli Bendersky submitted this change.

      View Change



      1 is the latest approved patch-set.
      The change was submitted with unreviewed changes in the following files:

      ```
      The name of the file: _content/doc/tutorial/generics.md
      Insertions: 1, Deletions: 1.

      @@ -25,7 +25,7 @@

      ## Prerequisites

      -* **An installation of Go 1.18 later.** For installation instructions, see
      +* **An installation of Go 1.18 or later.** For installation instructions, see

      [Installing Go](/doc/install).
      * **A tool to edit your code.** Any text editor you have will work fine.
      * **A command terminal.** Go works well using any terminal on Linux and Mac,
      ```
      ```
      The name of the file: _content/doc/tutorial/fuzz.md
      Insertions: 1, Deletions: 1.

      @@ -31,7 +31,7 @@

      ## Prerequisites

      -- **An installation of Go 1.18 later.** For installation instructions, see
      +- **An installation of Go 1.18 or later.** For installation instructions, see

      [Installing Go](/doc/install).
      - **A tool to edit your code.** Any text editor you have will work fine.
      - **A command terminal.** Go works well using any terminal on Linux and Mac, and
      ```

      Approvals: Dmitri Shuralyov: Looks good to me, approved Eli Bendersky: Trusted
      _content/doc: change generics and fuzz tutorials from beta

      Go 1.18 is released; these tutorials are now out of beta as well.

      Fixes golang/go#51688

      Change-Id: I5ded6c75f3131c97e3d2104146e0dff98dd7b1b0
      Reviewed-on: https://go-review.googlesource.com/c/website/+/393215
      Reviewed-by: Dmitri Shuralyov <dmit...@google.com>
      Trust: Eli Bendersky <eli...@google.com>

      ---
      M _content/doc/index.html
      M _content/doc/tutorial/fuzz.md
      M _content/doc/tutorial/generics.md
      3 files changed, 22 insertions(+), 91 deletions(-)

      diff --git a/_content/doc/index.html b/_content/doc/index.html
      index 6aaa239..bd872b6 100644
      --- a/_content/doc/index.html
      +++ b/_content/doc/index.html
      @@ -49,12 +49,12 @@
      Introduces the basics of writing a RESTful web service API with Go and the Gin Web Framework.
      </p>

      -<h3 id="generics-tutorial"><a href="/doc/tutorial/generics.html">Tutorial: Getting started with generics (beta)</a></h3>
      +<h3 id="generics-tutorial"><a href="/doc/tutorial/generics.html">Tutorial: Getting started with generics</a></h3>
      <p>
      With generics, you can declare and use functions or types that are written to work with any of a set of types provided by calling code.
      </p>

      -<h3 id="fuzz-tutorial"><a href="/doc/tutorial/fuzz.html">Tutorial: Getting started with fuzzing (beta)</a></h3>
      +<h3 id="fuzz-tutorial"><a href="/doc/tutorial/fuzz.html">Tutorial: Getting started with fuzzing</a></h3>
      <p>
      Fuzzing can generate inputs to your tests that can catch edge cases and security issues that you may have missed.
      </p>
      diff --git a/_content/doc/tutorial/fuzz.md b/_content/doc/tutorial/fuzz.md
      index 6d07cf6..450d166 100644

      --- a/_content/doc/tutorial/fuzz.md
      +++ b/_content/doc/tutorial/fuzz.md
      @@ -3,8 +3,6 @@
      "HideTOC": true
      }-->

      -> **Note: This is beta content.**
      -
      This tutorial introduces the basics of fuzzing in Go. With fuzzing, random data
      is run against your test in an attempt to find vulnerabilities or crash-causing
      inputs. Some examples of vulnerabilities that can be found by fuzzing are SQL
      @@ -33,55 +31,14 @@

      ## Prerequisites

      -- **An installation of Go 1.18 Beta 1 or later.** For installation instructions,
      - see [Installing and using the beta](#installing_beta).
      +- **An installation of Go 1.18 or later.** For installation instructions, see
      index 95c6583..c773b04 100644

      --- a/_content/doc/tutorial/generics.md
      +++ b/_content/doc/tutorial/generics.md
      @@ -2,8 +2,6 @@
      "Title": "Tutorial: Getting started with generics"
      }-->

      -> **Note: This is beta content.**
      -
      This tutorial introduces the basics of generics in Go. With generics, you can
      declare and use functions or types that are written to work with any of a set
      of types provided by calling code.
      @@ -27,52 +25,12 @@

      ## Prerequisites

      -* **An installation of Go 1.18 Beta 1 or later.** For installation
      - instructions, see [Installing and using the beta](#installing_beta).
      +*   **An installation of Go 1.18 or later.** For installation instructions, see

      To view, visit change 393215. To unsubscribe, or for help writing mail filters, visit settings.

      Gerrit-Project: website
      Gerrit-Branch: master
      Gerrit-Change-Id: I5ded6c75f3131c97e3d2104146e0dff98dd7b1b0
      Gerrit-Change-Number: 393215
      Gerrit-PatchSet: 3
      Gerrit-Owner: Eli Bendersky‎ <eli...@golang.org>
      Gerrit-Reviewer: Dmitri Shuralyov <dmit...@golang.org>
      Gerrit-Reviewer: Dmitri Shuralyov <dmit...@google.com>
      Gerrit-Reviewer: Eli Bendersky <eli...@google.com>
      Gerrit-Reviewer: Gopher Robot <go...@golang.org>
      Gerrit-Reviewer: Ian Lance Taylor <ia...@golang.org>
      Gerrit-MessageType: merged
      Reply all
      Reply to author
      Forward
      0 new messages