Merge pull request #228 from lxfontes/lxfontes/go-imports

ydnar · web-flow · commit dc6c46fcbf5c · 2024-11-05T22:10:09.000+01:00
docs: vanity url top directory
diff --git a/docs/README.md b/docs/README.md
@@ -0,0 +1,22 @@
+# go.bytecodealliance.org Go import paths
+
+This directory hosts the configuration for Go vanity URLs under `go.bytecodealliance.org` domain.
+
+More information about vanity URLs can be found in the [Go documentation](https://golang.org/cmd/go/#hdr-Remote_import_paths).
+
+## Adding a new vanity URL
+
+If you want to create a vanity URL `go.bytecodealliance.org/foo` pointing to `github.com/bytecodealliance/go-foo`:
+
+- Create directory `docs/foo`
+- Create file `docs/foo/index.html` with the following content:
+
+     ```html
+     <html>
+     	<head>
+     		<meta name="go-import" content="go.bytecodealliance.org/foo git https://github.com/bytecodealliance/go-foo" />
+     	</head>
+     </html>
+     ```
+
+NOTE: Vanity URLs must be unique and not shadow existing package names in this repository. For example: Creating a vanity URL `go.bytecodealliance.org/cm` would shadow the `cm` package in this repository.
diff --git a/docs/index.html b/docs/index.html
@@ -0,0 +1,5 @@
+<html>
+	<head>
+		<meta name="go-import" content="go.bytecodealliance.org git https://github.com/bytecodealliance/go-modules" />
+	</head>
+</html>

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +<html>
 +	<head>
 +		<meta name="go-import" content="go.bytecodealliance.org git https://github.com/bytecodealliance/go-modules" />
 +	</head>
 +</html>