Repository navigation
docs(grow-my-repo): edit other people's wikis in the web editor and save to Software Heritage without a browser #21
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -160,7 +160,7 @@ Here publishing is the listing. Floors are noted per place; recheck them each qu | |
| They bring trust, citations and long-tail search more than launch traffic. | ||
|
|
||
| - **Zenodo** `[worth it, owner enables once, then automatic]` Repos someone might cite. Route: link GitHub at https://zenodo.org/account/settings/github/ toggle the repo on, publish a release. Rule: "Zenodo archives your repository and issues a new DOI each time you create a new GitHub release."; "If your repository also contains a .zenodo.json file, Zenodo will only use the .zenodo.json metadata and ignore the CITATION.cff entirely." | ||
| - **Software Heritage** `[worth it, agent]` Every public repo. Route: https://archive.softwareheritage.org/save/ or a webhook on releases. Gives a citable SWHID. No login, and github.com origins are accepted with no human review, so a curator's day limit does not apply; the anonymous rate limit does (it tripped after ten saves in about three minutes on 2026-10-10). Read a request's state at `https://archive.softwareheritage.org/api/1/origin/save/git/url/<clone URL>/`, or add the webhook so releases save themselves. | ||
| - **Software Heritage** `[worth it, agent]` Every public repo. Route: https://archive.softwareheritage.org/save/ or a webhook on releases. Gives a citable SWHID. No login, and github.com origins are accepted with no human review, so a curator's day limit does not apply; the anonymous rate limit does (it tripped after ten saves in about three minutes on 2026-10-10). Read a request's state at `https://archive.softwareheritage.org/api/1/origin/save/git/url/<clone URL>/`, or add the webhook so releases save themselves. No browser is needed: an anonymous `POST` to that same URL files the save and answers `save_request_status: accepted` (2026-10-14), and the `GET` before it answers 404 "No save requests found" for a repo never saved. | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win Correct the future-dated observation. October 14, 2026 is after October 13, 2026. Correct the date or remove it; it cannot describe an observation already made. 🧰 Tools🪛 LanguageTool[uncategorized] ~163-~163: The official name of this software platform is spelled with a capital “H”. (GITHUB) 🤖 Prompt for AI Agents🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win Qualify the POST response status. The API can return 🧰 Tools🪛 LanguageTool[uncategorized] ~163-~163: The official name of this software platform is spelled with a capital “H”. (GITHUB) 🤖 Prompt for AI Agents |
||
| - **tldr-pages** `[situational, owner reviews]` CLIs maintained for a year. Rule: "Please ensure that the project has been maintained for at least a year"; "Pull requests suspected of being made in whole or in part through generative AI or machine translation software without human-review will be closed." Needs the CLA. https://github.com/tldr-pages/tldr/blob/main/CONTRIBUTING.md | ||
| - **Domain registries** `[worth it where they fit]` bio.tools and WorkflowHub for bioinformatics, Hugging Face datasets and Kaggle for data, Google Dataset Search through schema.org `Dataset` markup on a public page. | ||
| - **Context7** `[worth it, owner signs in]` Repos with docs people code against. Route: https://context7.com/add-library ("Anyone can add a public library"). Adding needs a sign-in, and its Cloudflare Turnstile refused an automated browser even after GitHub OAuth (2026-10-10). Look first with `https://context7.com/api/v1/<owner>/<repo>`. | ||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win
Correct the wiki observation date.
Line 119 says the push denial was seen on 2026-10-14, but the review date is 2026-10-13. Correct the date or describe this as a future check.
🤖 Prompt for AI Agents
🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win
Require the owner's account before saving the wiki edit.
Line 119 permits an outsider to use the web editor but does not require the owner's authenticated account. GitHub ties web-based commits to the account's commit identity, and wiki history records who made the change. If an agent saves while signed in as itself, the published commit will not be under the owner's identity. Line 120 checks this only after publication. Require the owner's account before saving, or hand the edit to the owner. (docs.github.com)
🤖 Prompt for AI Agents