Tighten the comparison and add what receivers need to handle in practice:
at-least-once and out-of-order delivery, signature verification (HMAC with
a shared secret), acknowledging quickly and processing in the background,
deduplicating by event ID, and combining webhooks with polling to catch
missed events.
Add the Standard Webhooks spec and GitHub's webhook best-practice and
signature-validation guides as resources.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
The topic said idempotency "sometimes" applies to POST but did not explain
how. Clarify which HTTP methods are idempotent by definition and describe
idempotency keys, the common way to make POST/PATCH safe to retry:
client-generated unique key, stored result replayed on repeats, reuse with
a different payload rejected, keys expire.
Add MDN, the IETF Idempotency-Key header draft and Stripe's reference
implementation as resources.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Rewrite the topic copy to reflect current practice: retry only transient
failures (timeouts, 429, 502-504), cap retries, use exponential backoff
with jitter, respect Retry-After, and retry only idempotent requests.
The old copy suggested retrying until a request succeeds, which can cause
retry storms.
Add three resources on backoff, jitter and Retry-After. No other topic in
the API Design, Backend or AI Engineer roadmaps covers these yet.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Remove the 272 daily.dev "Explore top posts about ..." feed links
from 274 topic files across all roadmaps.
Three links were tagged @feed@ but are regular resources, so they
are retagged instead of removed:
- computer-science/sql-vs-nosql-databases: roadmap.sh guide -> @article@
- backend-beginner/git: YouTube crash course -> @video@
- game-developer/unreal-engine: Unreal Source Discord -> @article@
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
A repo-wide scan found 34 resource lines that link to an identical URL
as another line in the same file. Most look like content-sync artifacts
where a refreshed resource was appended but the stale one was never
removed; three were created by my earlier link fixes folding a dead URL
into an identical live one (cloudflare calls, cloudflare service
bindings, kotlinlang flow).
In each file the first occurrence is kept and only the later duplicate
is removed; no URLs or labels were modified.
Co-authored-by: Weijian He <230282609+Madin-H23@users.noreply.github.com>
Live fixes (8 links, 8 files):
- chakra-ui: /docs/getting-started removed, updated to the docs hub
- LanceDB: /enterprise/introduction folded into the /enterprise section
- openclaw docs: five deep links into moved /index pages updated to the
canonical paths (gateway/security, cli)
Dropped 8 resource lines whose sources are gone with no replacement
(all 404-verified twice): arbitrum get-started, harness kubernetes
blue-green guide (2 files), smartbear microservices (2 files),
userfrosting DI container article, AWS effective_cache_size tuning
page, inspirednonsense context engineering post.
All replacement URLs verified to resolve (HTTP 200).
Co-authored-by: Weijian He <230282609+Madin-H23@users.noreply.github.com>
Live replacements (5):
- concurrent-ruby: versioned docs URL 404s, updated to the unversioned
docs home
- IBM prompt injection article: research.ibm.com moved to
ibm.com/think/insights
- bolt.new: support-center quickstart removed, linked the official docs
- ML Basics book PDF (mlops): dead github.io copy replaced with the
live copy in the book's GitHub repository
- libretexts unbalanced tree: corrected the page slug (had a stray
trailing 'e')
Dropped 14 resource lines whose sources are gone entirely with no
replacement (all 404-verified twice): cisco TCP error control doc,
vultr redis install guide, thenewstack kubernetes article, claude
support plan article, openclassrooms relational DB course,
cointelegraph crypto faucets, codewithmukesh NLog post, dhanusir ruby
naming (3 files), flexiple puts/print/p, loadninja load testing,
loadforge redis optimization, tpolecat by-name parameters.
All replacement URLs verified to resolve (HTTP 200).
Co-authored-by: Weijian He <230282609+Madin-H23@users.noreply.github.com>
* feat(inference-engineering): add learning resources to roadmap topics
Add curated papers, official docs, open-source repos and books to 64
topics of the Inference Engineering roadmap, following the content
style guide (typed links, ordered by type, max 8 per topic).
Also normalise the heading on the Post-Training Quantization and
Multi-Cloud topics.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* feat(inference-engineering): reuse AI Engineer roadmap resources
Add 39 resources already curated on the AI Engineer roadmap to 22
Inference Engineering topics where they fit (model selection and
evaluation, latency/cost trade-offs, caching, long context, embeddings,
ASR, VLMs, diffusion, desktop inference). At most 4 new links per
topic; existing links are kept and everything stays type-ordered.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Add curated papers, official docs, open-source repos and books to 64
topics of the Inference Engineering roadmap, following the content
style guide (typed links, ordered by type, max 8 per topic).
Also normalise the heading on the Post-Training Quantization and
Multi-Cloud topics.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
- OWASP API Security project: the www-project page was removed; the
project now lives at owasp.org/API-Security/ (3 files)
- OWASP ZAP: the project moved off OWASP pages to its own site,
zaproxy.org
- NPTEL: the course URL scheme changed from /courses/106/106/<id>/
to /courses/<id> (2 files)
All replacement URLs verified to resolve (HTTP 200).
Co-authored-by: Weijian He <230282609+Madin-H23@users.noreply.github.com>
Per maintainer guidance to prefer fresh content over archived files:
- gafferongames udp-vs-tcp (2 files): updated to the article's current
location at gafferongames.com/post/udp_vs_tcp/
- transaction script: the personal blog post is gone; linked Martin
Fowler's canonical Transaction Script page instead
- postgres buffer manager: the dev.to summary was deleted; linked the
original book chapter it summarized (The Internals of PostgreSQL,
ch.8 Buffer Manager)
- dropped two resource lines whose sources are gone entirely with no
replacement: businessdesign.org Business Model Inspirator (section
removed from the site) and a digger.dev Terraform/Jenkins post
(domain dead, label was also corrupted)
All replacement URLs verified to resolve (HTTP 200).
Co-authored-by: Weijian He <230282609+Madin-H23@users.noreply.github.com>
* docs: replace dead article links with archived snapshots
Six dead third-party article links replaced with Internet Archive
snapshots, and one resource line dropped:
- codedigest ASP.NET REST articles (2 files): site gone, archived
- awesome-architecture back-pressure: site gone, archived
- roblox forum stencil shadows thread: thread deleted, archived
- cglab.ca rust BTreeMap case study: page gone, archived
- levity.ai AI bias article: page gone, archived
- ignitetech synthetic voices article: page gone, archived
- alistapart brand strategy article: no live page and no archive
snapshot; resource line dropped (design-system/vision)
All snapshot URLs verified to resolve (HTTP 200).
* Update bias-and-fairness@lhIU0ulpvDAn1Xc3ooYz_.md
* Update text-to-speech resources in documentation
* Update REST resources in ASP.NET Core documentation
* Update rest@KJCtxH3mYsZq3hfBZ6cJF.md
* Update backpressure.md by removing a resource link
Removed a resource link and updated the formatting.
* Update resource links for stencil shadows
* Remove outdated BTreeMap article link
Removed outdated article link for BTreeMap.
---------
Co-authored-by: Weijian He <230282609+Madin-H23@users.noreply.github.com>
Co-authored-by: Javier Canales <56018501+jcanalesluna@users.noreply.github.com>
- boffin.education restructured its site; the three technical-writer
articles now live in the Internet Archive
- Apple removed the uifont scaling_fonts_automatically page; archived
snapshot linked
- MDN removed the text-level_semantics page; link updated to the HTML
element index (Text content / Inline text semantics sections)
- MDN HTML5 notes page has no replacement or archive; dropped the
resource line (html/case-insensitivity)
All snapshot URLs verified to resolve (HTTP 200).
Co-authored-by: Weijian He <230282609+Madin-H23@users.noreply.github.com>
- NIST glossary terms: add trailing slashes (404 without them)
- Swift Package Manager docs: update to swift.org/docs hub (old
docs.swift.org/swiftpm pages removed)
- Apple: about Apple File System moved to the File System docs group;
WWDC24 community page folded into the WWDC24 hub
- Cloudflare Workers: service bindings moved under Runtime APIs bindings
All replacement URLs verified to resolve (HTTP 200).
Co-authored-by: Weijian He <230282609+Madin-H23@users.noreply.github.com>
- Escape parentheses in the Column/Row composable anchor URLs (android)
and the Bash Wikipedia URL (shell-bash) so the links are not cut off
at the first unescaped parenthesis, matching #10397
- Remove stray '](' in the DNS video resource link (devsecops)
All fixed URLs verified to resolve (HTTP 200).
Co-authored-by: Weijian He <230282609+Madin-H23@users.noreply.github.com>
* docs: drop stale Local Development entry from contributing TOC
Signed-off-by: yuwk <1729065730@qq.com>
* docs: escape parentheses in external resource links
Signed-off-by: yuwk <1729065730@qq.com>
---------
Signed-off-by: yuwk <1729065730@qq.com>
