Author, review, and publish Markdown and API docs with a Git-based docs-as-code workflow
Helsinki, Finland
Joined August 2020
- Tweets124
- Following15
- Followers65
- Likes23
Pinned Tweet
Doctave 2.0 is here! 🎉
This release brings with it...
- A brand new Markdown-aware component library for creating compelling and engaging articles
- An improved, customizable design, with the familiar Doctave layout
...and much more! We're excited to see what you build!
ALT The text "2.0" floating in a cloudy sky colored by a sunrise. Doctave's logo is monochrome in the top left corner against the clouds.
Doctave retweeted
We're building a brand new editor for technical writing and docs-as-code at @GetDoctave!
We're pushing the boundaries of what an editor for documentation and technical writing professionals could look like.
Interested? Join the waitlist! Link below 👇
ALT A screenshot of Doctave Studio 2.0: Doctave's upcoming editor for technical writing and docs-as-code.
Doctave retweeted
I had the pleasure of chatting with Manny Silva about his work on VerbaGPT, and how he uses LLMs to cut his time-to-first-draft from 2 days to an incredible 5 minutes
Full conversation on YouTube 👇
youtu.be/fr-t0gMmrFk
Doctave retweeted
Granted @GetDoctave isn't a particularly data-heavy app, I feel like we just crossed some kind of milestone because we had to add a missing database index to address a performance issue.
Resulted in a good 150ms faster page loads for some customers!
This was a great discussion! Thank you to @remoquete for joining us!
My discussion about Markdown and Structured Authoring with @remoquete is out!
We discussed lots of interesting ideas about how to bring structured authoring concepts into a docs-as-code context
Take a look!
youtube.com/watch?v=M5L0xyER…
Doctave retweeted
My discussion about Markdown and Structured Authoring with @remoquete is out!
We discussed lots of interesting ideas about how to bring structured authoring concepts into a docs-as-code context
Take a look!
youtube.com/watch?v=M5L0xyER…
Tune in next week for the full discussion!
Had the pleasure of chatting with @remoquete last week about Markdown and Structured Authoring!
We talked about what structured authoring would look like in a docs-as-code, context and ways we could get there.
Tune in Monday next week for the full discussion!
ALT Banner image for the fireside chat about Markdown & Structured Authoring with Fabrizio Ferry Benedetti. The image has a picture of Fabrizio on the left, and Nik, the interviewer, on the left.
Doctave retweeted
Your docs are the product.
For some companies, the docs are the biggest touch point that the your user will interact with. Much more important than the copy on your marketing site.
Invest in your docs, hire tech writers, make your users happy.
We've added diagram support powered by @mermaidjs_ 📈
You can now add flowcharts, pie charts, gantt charts and more, defined as text inline inside your Markdown content.
Doctave retweeted
Still think you should think twice about putting an AI in front of your carefully written developer docs.
Your users are not experts in your product. They cannot tell when the LLM is hallucinating and making up features, which it inevitably will (for now at least).
We've just published the first in a series of Doctave tutorial videos 🎬
Find them in our docs 👉 docs.doctave.com/videos
ALT Screenshot of a Doctave tutorial video with a banner underneath saying "Tutorial video series"
How can we foster a culture of documentation?
Learn what worked for engineers and technical writers at Google, Twitter, and Spotify 👀
doctave.com/blog/2021/09/07/…
👀
I wrote about what it would take to bridge the gap between Markdown and structured authoring
TL;DR, Markdown has more structure than you'd think, and it's really a matter of tooling to make it a reality.
doctave.com/blog/path-to-str…
Doctave retweeted
@GetDoctave is amazing. The team is super approachable
Doctave retweeted
The @GetDoctave team is at @ApidaysHelsinki!
Come find us if you want to chat about API documentation 👀
We created a new Markdown-aware component system for 2.0 👀
You can:
- Embed interactive UI components directly in Markdown
- Nest Markdown and components together
- And even create custom reusable components
And keeping with our music-inspired brand, we're calling it Ballad
ALT A code snippet showing how to use a Tab component with code snippets, and the resulting output. The code shows the 3 tabs, one for macOS, one for Linux, and one for Windows, each with a platform-specific code sample. The output shows the macOS sample as it's the currently selected tab.
You can read more about Ballad on our tech blog: doctave.com/blog/ballad-comp…