Prompt
What should I use to publish a deep tutorial about my API product?
Latest observation
For a deep tutorial about your API product, the best place to publish depends on your goal:
Best options
-
Your own docs site or developer portal
Best if you want the tutorial to be part of the official product experience, easy to maintain, and tightly linked to your API reference. -
A blog post on your company site
Good for discoverability, SEO, and sharing a narrative/tutorial style guide. -
A dedicated knowledge base/article in your docs
Best if the tutorial is technical and meant to help developers actually implement something.
If you want maximum reach
- Dev.to
- Hashnode
- Medium
- LinkedIn article
Useful if you want to attract new developers and drive traffic back to your product.
My recommendation
If this is a serious deep tutorial for users of your API, publish it in your docs/developer portal, and then republish or summarize it on your blog or Dev.to with a link back to the canonical version.
Good rule of thumb
- Documentation/tutorial for existing users: docs site
- Marketing + SEO: blog
- Developer community reach: Dev.to / Hashnode
- Thought leadership: LinkedIn / Medium
If you want, I can also recommend the best platform based on your audience or help you choose between docs vs blog vs Dev.to.