From 455282911aba7512e2ba045ffd9244eb97756247 Mon Sep 17 00:00:00 2001
From: Carlos Amedee <carlos@golang.org>
Date: Wed, 21 Jan 2026 14:52:52 -0500
Subject: [PATCH] doc/next: initialize

Initialize the doc/next directory for the next release by copying the
contents of doc/initial into it.

For #76474.

Change-Id: I52c826cf42aa93f1dea8bf8f7f386a77265bf31a
Reviewed-on: https://go-review.googlesource.com/c/go/+/737961
Reviewed-by: Michael Pratt <mpratt@google.com>
Auto-Submit: Carlos Amedee <carlos@golang.org>
TryBot-Bypass: Carlos Amedee <carlos@golang.org>
---
 doc/next/1-intro.md                     | 8 ++++++++
 doc/next/2-language.md                  | 3 +++
 doc/next/3-tools.md                     | 6 ++++++
 doc/next/4-runtime.md                   | 1 +
 doc/next/5-toolchain.md                 | 7 +++++++
 doc/next/6-stdlib/0-heading.md          | 2 ++
 doc/next/6-stdlib/99-minor/0-heading.md | 1 +
 doc/next/6-stdlib/99-minor/README       | 1 +
 doc/next/7-ports.md                     | 2 ++
 9 files changed, 31 insertions(+)
 create mode 100644 doc/next/1-intro.md
 create mode 100644 doc/next/2-language.md
 create mode 100644 doc/next/3-tools.md
 create mode 100644 doc/next/4-runtime.md
 create mode 100644 doc/next/5-toolchain.md
 create mode 100644 doc/next/6-stdlib/0-heading.md
 create mode 100644 doc/next/6-stdlib/99-minor/0-heading.md
 create mode 100644 doc/next/6-stdlib/99-minor/README
 create mode 100644 doc/next/7-ports.md

diff --git a/doc/next/1-intro.md b/doc/next/1-intro.md
new file mode 100644
index 00000000000..fb88f7e9e2f
--- /dev/null
+++ b/doc/next/1-intro.md
@@ -0,0 +1,8 @@
+<style>
+  main ul li { margin: 0.5em 0; }
+</style>
+
+## DRAFT RELEASE NOTES — Introduction to Go 1.27 {#introduction}
+
+**Go 1.27 is not yet released. These are work-in-progress release notes.
+Go 1.27 is expected to be released in August 2026.**
diff --git a/doc/next/2-language.md b/doc/next/2-language.md
new file mode 100644
index 00000000000..61030bd6760
--- /dev/null
+++ b/doc/next/2-language.md
@@ -0,0 +1,3 @@
+## Changes to the language {#language}
+
+
diff --git a/doc/next/3-tools.md b/doc/next/3-tools.md
new file mode 100644
index 00000000000..5638f240a5b
--- /dev/null
+++ b/doc/next/3-tools.md
@@ -0,0 +1,6 @@
+## Tools {#tools}
+
+### Go command {#go-command}
+
+### Cgo {#cgo}
+
diff --git a/doc/next/4-runtime.md b/doc/next/4-runtime.md
new file mode 100644
index 00000000000..1f8e445e0b1
--- /dev/null
+++ b/doc/next/4-runtime.md
@@ -0,0 +1 @@
+## Runtime {#runtime}
diff --git a/doc/next/5-toolchain.md b/doc/next/5-toolchain.md
new file mode 100644
index 00000000000..0f4a8164797
--- /dev/null
+++ b/doc/next/5-toolchain.md
@@ -0,0 +1,7 @@
+## Compiler {#compiler}
+
+## Assembler {#assembler}
+
+## Linker {#linker}
+
+
diff --git a/doc/next/6-stdlib/0-heading.md b/doc/next/6-stdlib/0-heading.md
new file mode 100644
index 00000000000..a992170d433
--- /dev/null
+++ b/doc/next/6-stdlib/0-heading.md
@@ -0,0 +1,2 @@
+## Standard library {#library}
+
diff --git a/doc/next/6-stdlib/99-minor/0-heading.md b/doc/next/6-stdlib/99-minor/0-heading.md
new file mode 100644
index 00000000000..266d98f496a
--- /dev/null
+++ b/doc/next/6-stdlib/99-minor/0-heading.md
@@ -0,0 +1 @@
+### Minor changes to the library {#minor_library_changes}
diff --git a/doc/next/6-stdlib/99-minor/README b/doc/next/6-stdlib/99-minor/README
new file mode 100644
index 00000000000..fac778de050
--- /dev/null
+++ b/doc/next/6-stdlib/99-minor/README
@@ -0,0 +1 @@
+API changes and other small changes to the standard library go here.
diff --git a/doc/next/7-ports.md b/doc/next/7-ports.md
new file mode 100644
index 00000000000..8bea3f8fbc3
--- /dev/null
+++ b/doc/next/7-ports.md
@@ -0,0 +1,2 @@
+## Ports {#ports}
+