From d29980cdc4a8776257b1ca0d03549da205b39d3e Mon Sep 17 00:00:00 2001
From: Jonathan Amsterdam <jba@google.com>
Date: Thu, 18 Jan 2024 19:34:48 -0500
Subject: [PATCH] doc/initial: initial contents of release notes

Add files to doc/initial that set up the overall structure
of the release notes document.

For #64169.

Change-Id: Ifbf330e554e1fa20d47c72cc309d5cd26048a323
Reviewed-on: https://go-review.googlesource.com/c/go/+/556817
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
---
 doc/initial/1-intro.md                     | 12 ++++++++++++
 doc/initial/2-language.md                  |  3 +++
 doc/initial/3-tools.md                     |  6 ++++++
 doc/initial/4-runtime.md                   |  1 +
 doc/initial/5-toolchain.md                 |  7 +++++++
 doc/initial/6-stdlib/0-heading.md          |  2 ++
 doc/initial/6-stdlib/99-minor/0-heading.md |  3 +++
 doc/initial/6-stdlib/99-minor/README       |  1 +
 doc/initial/7-ports.md                     |  2 ++
 9 files changed, 37 insertions(+)
 create mode 100644 doc/initial/1-intro.md
 create mode 100644 doc/initial/2-language.md
 create mode 100644 doc/initial/3-tools.md
 create mode 100644 doc/initial/4-runtime.md
 create mode 100644 doc/initial/5-toolchain.md
 create mode 100644 doc/initial/6-stdlib/0-heading.md
 create mode 100644 doc/initial/6-stdlib/99-minor/0-heading.md
 create mode 100644 doc/initial/6-stdlib/99-minor/README
 create mode 100644 doc/initial/7-ports.md

diff --git a/doc/initial/1-intro.md b/doc/initial/1-intro.md
new file mode 100644
index 0000000000..e28191ca9e
--- /dev/null
+++ b/doc/initial/1-intro.md
@@ -0,0 +1,12 @@
+<!--
+NOTE: In this document and others in this directory, the convention is to
+set fixed-width phrases with non-fixed-width spaces, as in
+`hello` `world`.
+-->
+
+<style>
+  main ul li { margin: 0.5em 0; }
+</style>
+
+## Introduction to Go 1.XX {#introduction}
+
diff --git a/doc/initial/2-language.md b/doc/initial/2-language.md
new file mode 100644
index 0000000000..61030bd676
--- /dev/null
+++ b/doc/initial/2-language.md
@@ -0,0 +1,3 @@
+## Changes to the language {#language}
+
+
diff --git a/doc/initial/3-tools.md b/doc/initial/3-tools.md
new file mode 100644
index 0000000000..5638f240a5
--- /dev/null
+++ b/doc/initial/3-tools.md
@@ -0,0 +1,6 @@
+## Tools {#tools}
+
+### Go command {#go-command}
+
+### Cgo {#cgo}
+
diff --git a/doc/initial/4-runtime.md b/doc/initial/4-runtime.md
new file mode 100644
index 0000000000..1f8e445e0b
--- /dev/null
+++ b/doc/initial/4-runtime.md
@@ -0,0 +1 @@
+## Runtime {#runtime}
diff --git a/doc/initial/5-toolchain.md b/doc/initial/5-toolchain.md
new file mode 100644
index 0000000000..0f4a816479
--- /dev/null
+++ b/doc/initial/5-toolchain.md
@@ -0,0 +1,7 @@
+## Compiler {#compiler}
+
+## Assembler {#assembler}
+
+## Linker {#linker}
+
+
diff --git a/doc/initial/6-stdlib/0-heading.md b/doc/initial/6-stdlib/0-heading.md
new file mode 100644
index 0000000000..a992170d43
--- /dev/null
+++ b/doc/initial/6-stdlib/0-heading.md
@@ -0,0 +1,2 @@
+## Standard library {#library}
+
diff --git a/doc/initial/6-stdlib/99-minor/0-heading.md b/doc/initial/6-stdlib/99-minor/0-heading.md
new file mode 100644
index 0000000000..a98105e8cc
--- /dev/null
+++ b/doc/initial/6-stdlib/99-minor/0-heading.md
@@ -0,0 +1,3 @@
+### Minor changes to the library {#minor_library_changes}
+
+
diff --git a/doc/initial/6-stdlib/99-minor/README b/doc/initial/6-stdlib/99-minor/README
new file mode 100644
index 0000000000..fac778de05
--- /dev/null
+++ b/doc/initial/6-stdlib/99-minor/README
@@ -0,0 +1 @@
+API changes and other small changes to the standard library go here.
diff --git a/doc/initial/7-ports.md b/doc/initial/7-ports.md
new file mode 100644
index 0000000000..8bea3f8fbc
--- /dev/null
+++ b/doc/initial/7-ports.md
@@ -0,0 +1,2 @@
+## Ports {#ports}
+
-- 
2.48.1