Add dev.to markdown for the trace-attribution post - #6
Open
tishachawla-jg wants to merge 4 commits into
Open
Conversation
- blog/bug-report-to-exact-trace.devto.md: dev.to-specific front matter (published: false draft, description, tags: ai/llm/python/opensource picked by actual dev.to tag post-counts for reach: ai 348k, python 118k, opensource 89k, llm 26k, all genuinely on-topic, not tag-stuffed; cover_image; canonical_url pointing at the site so SEO authority stays with theagentplane.github.io regardless of which account publishes it). Plain markdown images (dev.to doesn't reliably render raw <img>), a GitHub repo embed for the Chronicle CTA, and @mentions of both dev.to handles (@susheem-k, @tisha) in the byline. - Documented in add-media-item/SKILL.md why dev.to can't do real co-authored posts on personal accounts (no theagentplane org exists) and what the practical alternative is: one account publishes, mentions the other, canonical_url keeps the site as the real source of truth. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
canonical_url in front matter handles SEO, but readers never see front matter; add the same link visibly in the byline so it's obvious on the rendered page too. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
The Envelope box sat at x=780 width=190 (spans to x=970), but the SVG canvas/viewBox was only 920 wide, clipping the box border and "One LLM/tool call" text on the right edge. Widened canvas to 1000 and recentered the caption. Found this while rendering a static PNG export for dev.to and comparing against the live diagram, the site itself has been showing this clipped for as long as the post has been up. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
dev.to proxies external images through Cloudinary, and SVG support through that pipeline isn't reliably documented, better not to risk broken images on publish. Rendered all three diagrams to PNG via headless Edge and pointed cover_image + the three inline images at those instead. Documented the render command (with the animation-settling flag for the waterfall) in add-media-item/SKILL.md for future posts. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Contributor
Author
|
Answering "images to upload?": no manual upload needed, dev.to fetches from URLs directly. But switched the three diagrams (and cover_image) from Also found and fixed a real bug while generating these: |
3 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
On "collaborate post"
dev.to doesn't support real multi-author posts on personal accounts, only Organizations do, and no `theagentplane` org exists yet (checked both https://dev.to/susheem-k and https://dev.to/tisha). I didn't create one, that's an account-creation step for one of you to do if you want true shared publishing going forward.
What this file does instead, the standard workaround: publish from one account, `@mention` the other's handle in the byline (dev.to turns that into a real profile link and notifies them), and let `canonical_url` keep the site as the actual source of truth either way. Byline currently reads "Co-written with @susheem-k / @tisha", works the same regardless of which of you pastes it in.
Documented this convention (3-file pattern: `.html` / `.md` / `.devto.md`) in `claude-skills/add-media-item/SKILL.md` for future posts.
🤖 Generated with Claude Code