Changelog
Dated, newest first.
2026-11-12
- The site now serves version 0.2 of the DEVREL.md spec. ICPs are named by what developers are building and add hiring moment, goals, pains, alternatives and switching forces. North Star puts a team-chosen metric above time to Hello World. Activation adds retention.
stagenow counts activated developers a month instead of signups. The Competitors section is gone. The spec's changelog has a migration note for 0.1 files. - The hosted generator and the
devrel-md-initskill now write 0.2 files, and the home page, quickstart and API examples show 0.2.
2026-10-29
- The footer, the home page and
llms.txtnow link to the maintainer's profile at marcos.md, a one-page profile written for people and AI agents.
2026-10-08
- Every page now has a GitHub button in the header, next to the theme switch, linking to the DEVREL.md repositories so you can read the source and contribute.
- The records from the retired unlock form have been deleted, as the privacy notice promised.
- The home page and quickstart no longer say agents pick up DEVREL.md on their own. They now give an instruction to add to
AGENTS.mdorCLAUDE.mdso your agent reads it before developer relations work, and say that only the devrel.md skills look for the file automatically. - The home page example is labelled as an excerpt and links to the complete example. The "With DEVREL.md" quickstart opening now uses the example's measured 22 minutes instead of its 5-minute target, and no longer lists version requirements the file doesn't state.
- The home page has a Contribute section: where to report problems or propose changes, who maintains DEVREL.md, and links to AGENTS.md and Corey Haines' marketing skills as related, independent work.
- The privacy notice now says what we still hold from the retired unlock form: nothing uses it any more and it will be deleted. The never-launched email series has been removed for good.
2026-10-04
- Generated result pages now say they are automated drafts, when they were made and from how many public pages, and how to have one corrected or removed. They are open to search engines only when the draft passed every check and states at least one fact from the pages; otherwise they are marked
noindex. A site can opt out by disallowingdevrel.md-generatorin robots.txt, and a company that publishes its own valid DEVREL.md is linked as the canonical version. - Community signups now reach the contact database: confirmed subscribers are added to the DEVREL.md community group, and unsubscribing removes them from it.
- There is now a Contribute link in the footer and a link in the home page FAQ to the contribution guide, which explains how to report problems, propose changes or skills, and how decisions are made.
- The quickstart now has a "Testing safely" section: how caching, the daily limits and the free validator let you try things without cost, and that there is no separate sandbox.
- Generated files are checked more strictly. A current number must appear in the pages next to the metric it describes, so a gate threshold or an unrelated price can no longer stand in for a measurement, and targets must be placeholders, the spec's default thresholds or figures the pages state. Result and validate pages now say this is number matching, not fact checking.
- Generated files are free. You can read, copy and download the full DEVREL.md for any result without giving an email address.
- Joining community updates is optional and separate from the result. It asks for an email address only, and signing up is not a request for sales contact. It is double opt-in: the form checks you are human, we email a confirmation link that works for seven days, and you are only subscribed once you confirm. Every email carries an unsubscribe link.
- The old "unlock copy and download" form is retired.
- The skills catalog and
llms.txtshow a one-line summary and an install command for each skill. Chapter references are shown on their own, with the book and both authors credited once above the table. - Pages now send standard security headers and a strict content security policy. Links and images inside generated files are checked before they are shown, so a generated file cannot link to
javascript:addresses or load remote images. /healthznow reports whether the production configuration is complete, and features that would be unsafe on development defaults refuse to run instead.- Daily limits can no longer be bypassed by sending a forged
X-Forwarded-Forheader. Visitors on IPv6 are limited per network rather than per address, and requests with no trustworthy address share one small allowance. /robots.txtand/sitemap.xmlnow use the live site address instead of a localhost one.
2026-09-30
- The generator only states what the fetched pages say. It now reads robots.txt properly, so sites that allow some paths inside a disallowed folder are no longer treated as blocked. Every figure in a draft has to appear in the pages it read, and if it could not read enough of a site it says so instead of guessing.
- Results explain unknown stage gates. When none of the gates can be judged from public pages, the result says why, shows what we found for each stage, and names the first thing to measure.
- Clearer messages when a site cannot be read: a mistyped URL says the page returned 404, a robots.txt block says so, and a refused request names the HTTP status. Each still offers the no-install agent prompt.
- The generator shows its progress: reading your docs, pages read, drafting, and a retry on another model with the reason, plus an elapsed-seconds counter. Runs that stall now stop instead of hanging, and a failed run lets you retry without reloading.
- Cached results and sites we could not read no longer use up your daily generation limit. Only a run that calls a model counts.
2026-09-29
- The home page is now a short introduction to DEVREL.md. The full specification moved to
/spec. - Added
/quickstart, a real getting-started page. - Added
/validate: paste a DEVREL.md and get a plain-language fix for every problem, plus a stage-gates summary when the file can be read. It needs no login, and also works fromPOST /api/validate. Validating has its own daily limit, separate from the generator's. - Added the API reference at
/apiand the OpenAPI document at/openapi.json, covering the generator and the validator. Neither needs a key or an account. - The generator form now tells you when verification fails instead of sitting silent, and its output streams as it is written.
- One shared header and footer on every page, the DEVREL.md logo and favicons, and updated navigation, sitemap and
llms.txt. - Replies to emails from the site now reach [email protected].
2026-09-28
- First build of the site: the spec, the example, the template, the skills catalog, the generator, tracked
/go/links, and content negotiation socurl devrel.mdand a browser both get the right thing. - Generator model fallback:
nvidia/nemotron-3-ultra-550b-a55b:freefirst, thenopenai/gpt-6-luna, thendeepseek/deepseek-v4-flash, gated by a quality check and a daily spend cap.