Doctave

Author, review, and publish Markdown and API docs with a Git-based docs-as-code workflow

[Doctave @GetDoctave]

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!

[Niklas Begley @NiklasBegley]

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 👇

[Niklas Begley @NiklasBegley]

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 👇

https://t.co/jI1bAfNNh0

[Niklas Begley @NiklasBegley]

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!

[Doctave @GetDoctave]

This was a great discussion! Thank you to @remoquete for joining us!

[Niklas Begley @NiklasBegley]

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!

https://t.co/x5JDfhtSJP

[Niklas Begley @NiklasBegley]

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!

https://t.co/x5JDfhtSJP

[Doctave @GetDoctave]

Tune in next week for the full discussion!

[Niklas Begley @NiklasBegley]

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!

[Niklas Begley @NiklasBegley]

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.

[Doctave @GetDoctave]

We put a lot of thought into code examples in Doctave 2.0 👩‍💻

✅ Multi-language examples
✅ Add descriptive titles
✅ Copy to clipboard
✅ Syntax highlighting
✅ Combines with other components like tabs

[Doctave @GetDoctave]

👀

[Niklas Begley @NiklasBegley]

Are you building your developer docs from content spread across multiple Git repositories? If so, I'd love to talk to you!

We're going to be releasing some cool stuff in the coming months. See 👇

[Doctave @GetDoctave]

You can find the docs here 👉 https://t.co/OQ4AVzZaK7

[Doctave @GetDoctave]

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.

[Niklas Begley @NiklasBegley]

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).

[Doctave @GetDoctave]

We've just published the first in a series of Doctave tutorial videos 🎬

Find them in our docs 👉 https://t.co/s8zVjdSIaU

[Doctave @GetDoctave]

How can we foster a culture of documentation?

Learn what worked for engineers and technical writers at Google, Twitter, and Spotify 👀

https://t.co/GUh3ZHiE3m

[Doctave @GetDoctave]

👀

[Niklas Begley @NiklasBegley]

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.

https://t.co/w8Z4RRs6vn

[Doctave @GetDoctave]

Check out the docs!

https://t.co/tNH7ms3vse

[Doctave @GetDoctave]

We've added Math support! 🚀

You can now add beautifully typeset equations to your documentation using the familiar TeX syntax.

[Sindre Reino Trosterud @STrosterud]

@t3dotgg @GetDoctave is amazing. The team is super approachable

[Niklas Begley @NiklasBegley]

The @GetDoctave team is at @ApidaysHelsinki!

Come find us if you want to chat about API documentation 👀

[Doctave @GetDoctave]

You can read more about Ballad on our tech blog: https://t.co/SMyG89sDSJ

[Doctave @GetDoctave]

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