Skip to content

Commit 0f8a84f

Browse files
committed
docs: add search indexing owner action
1 parent 50b5eaa commit 0f8a84f

5 files changed

Lines changed: 94 additions & 3 deletions

File tree

docs/launch/index.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -331,6 +331,7 @@ <h2 id="links">Links</h2>
331331
<li><a href="../debug-browser-agent-failure.html">Debugging walkthrough</a></li>
332332
<li><a href="press-kit.md">Press kit source</a></li>
333333
<li><a href="directory-submission-sheet.md">Directory submission sheet</a></li>
334+
<li><a href="search-indexing-submission.md">Search indexing submission</a></li>
334335
<li><a href="owner-next-actions.md">Owner next actions</a></li>
335336
<li><a href="github-profile-readme.md">GitHub profile README draft</a></li>
336337
<li><a href="https://github.com/aaronlab/browsertrace/releases/tag/v0.1.10">Release v0.1.10</a></li>

docs/launch/metrics-log.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,3 +96,4 @@ uv run --python 3.11 python scripts/launch_metrics.py --json
9696
| 2026-05-09T12:28:59+00:00 | 3 | 998 | 1 | 0 | 10 | 0 | 6 | after first external fork source verified: Jah-yee/browsertrace; traffic views 48/25 unique, clones 100/52 unique |
9797
| 2026-05-09T12:32:28+00:00 | 3 | 998 | 1 | 0 | 11 | 0 | 6 | after social preview owner-action issue #15; traffic views 48/25 unique, clones 100/52 unique |
9898
| 2026-05-09T12:35:45+00:00 | 3 | 998 | 1 | 0 | 11 | 0 | 6 | after launch discussion social-preview/SEO update: https://github.com/aaronlab/browsertrace/discussions/6#discussioncomment-16862100; traffic views 48/25 unique, clones 100/52 unique |
99+
| 2026-05-09T12:38:51+00:00 | 3 | 998 | 1 | 0 | 12 | 0 | 6 | after search indexing owner-action issue #16; traffic views 48/25 unique, clones 100/52 unique |

docs/launch/owner-next-actions.md

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,25 @@ BrowserTrace card instead of a generated GitHub card.
7070

7171
Tracking issue: https://github.com/aaronlab/browsertrace/issues/15
7272

73-
## 4. Publish Day 1 Posts
73+
## 4. Submit The Sitemap To Search Consoles
74+
75+
Search indexing is a slower growth channel, but it compounds after launch. The
76+
sitemap and robots file are already live:
77+
78+
```text
79+
https://aaronlab.github.io/browsertrace/sitemap.xml
80+
https://aaronlab.github.io/browsertrace/robots.txt
81+
```
82+
83+
Use:
84+
85+
```text
86+
docs/launch/search-indexing-submission.md
87+
```
88+
89+
Tracking issue: https://github.com/aaronlab/browsertrace/issues/16
90+
91+
## 5. Publish Day 1 Posts
7492

7593
Use this packet:
7694

@@ -89,7 +107,7 @@ Use `docs/demo.mp4` as primary media and `docs/demo-poster.png` as backup.
89107

90108
Tracking issue: https://github.com/aaronlab/browsertrace/issues/9
91109

92-
## 5. Submit Directories And Newsletters
110+
## 6. Submit Directories And Newsletters
93111

94112
Use:
95113

@@ -102,7 +120,7 @@ Submit once per target. Do not repeatedly submit or ask for votes.
102120

103121
Tracking issue: https://github.com/aaronlab/browsertrace/issues/10
104122

105-
## 6. Record Metrics After Each Action
123+
## 7. Record Metrics After Each Action
106124

107125
After every public post, profile update, PyPI publish, or directory submission:
108126

docs/launch/owner-publish-queue.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ Shortest owner checklist: `docs/launch/owner-next-actions.md`
2727
- Social preview: `docs/social-preview.png`
2828
- Public-safe demo export: `browsertrace-demo-public.html` attached to release `v0.1.10`
2929
- Press kit: `docs/launch/press-kit.md`
30+
- Search indexing submission: `docs/launch/search-indexing-submission.md`
3031

3132
## Day 1 Warm Launch
3233

@@ -41,6 +42,10 @@ Use `docs/launch/day-1-publish-packet.md` as the single owner-facing checklist.
4142
General -> Social preview before external posts.
4243
- Social preview tracking issue:
4344
https://github.com/aaronlab/browsertrace/issues/15
45+
- Search indexing: submit `https://aaronlab.github.io/browsertrace/sitemap.xml`
46+
in Google Search Console and Bing Webmaster Tools.
47+
- Search indexing tracking issue:
48+
https://github.com/aaronlab/browsertrace/issues/16
4449

4550
1. X
4651
- Use the `## X` draft in `docs/launch/channel-copy.md`.
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
# BrowserTrace Search Indexing Submission
2+
3+
This is an owner-only checklist for getting the GitHub Pages launch surface into
4+
Google Search Console and Bing Webmaster Tools. Codex can prepare files and add
5+
verification tokens, but the owner must sign in and verify ownership.
6+
7+
## Ready URLs
8+
9+
| Surface | URL |
10+
|---|---|
11+
| Homepage | `https://aaronlab.github.io/browsertrace/` |
12+
| Sitemap | `https://aaronlab.github.io/browsertrace/sitemap.xml` |
13+
| Robots | `https://aaronlab.github.io/browsertrace/robots.txt` |
14+
| Repository | `https://github.com/aaronlab/browsertrace` |
15+
| Launch kit | `https://aaronlab.github.io/browsertrace/launch/` |
16+
17+
## Google Search Console
18+
19+
1. Add a URL-prefix property for `https://aaronlab.github.io/browsertrace/`.
20+
2. Choose an HTML tag or HTML file verification method.
21+
3. If Search Console gives you a meta tag, paste the full tag into issue #16 so
22+
it can be added to `docs/index.html`.
23+
4. If Search Console gives you an HTML verification file, attach or paste the
24+
filename and contents into issue #16 so it can be added under `docs/`.
25+
5. After ownership verification, submit:
26+
27+
```text
28+
https://aaronlab.github.io/browsertrace/sitemap.xml
29+
```
30+
31+
6. Use URL Inspection on the homepage and request indexing if the control is
32+
available.
33+
34+
## Bing Webmaster Tools
35+
36+
1. Add BrowserTrace to Bing Webmaster Tools.
37+
2. Prefer importing the verified Google Search Console property if available.
38+
3. Submit the same sitemap:
39+
40+
```text
41+
https://aaronlab.github.io/browsertrace/sitemap.xml
42+
```
43+
44+
4. Check sitemap status and record any crawl or indexing errors in issue #16.
45+
46+
## After Submission
47+
48+
Record metrics after each verified submission:
49+
50+
```bash
51+
uv run --python 3.11 python scripts/launch_metrics.py --append --note "after Google Search Console sitemap submission"
52+
uv run --python 3.11 python scripts/launch_metrics.py --append --note "after Bing Webmaster Tools sitemap submission"
53+
```
54+
55+
Use `docs/launch/metrics-log.md` for the running log. Treat indexing as a
56+
long-tail discovery channel; do not use fake traffic, click farms, doorway
57+
pages, or keyword-stuffed pages.
58+
59+
Official references:
60+
61+
- Google Search Console Sitemaps report:
62+
`https://support.google.com/webmasters/answer/7451001`
63+
- Google Search Central sitemap submission:
64+
`https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap`
65+
- Bing Webmaster Tools:
66+
`https://www.bing.com/webmaster`

0 commit comments

Comments
 (0)