@NiklasBegley

Founder @GetDoctave | Paving a documentation happy path

 Helsinki, Finland
doctave.com
Joined January 2012
  • Tweets401
  • Following512
  • Followers225
31Media
We've been happy users of @TauriApps for well over a year now at @GetDoctave. Really solid. We've just started building a new text editor/IDE for documentation based on it. Excited to see the project grow!
Tauri@TauriApps2 Oct 2024
Tauri 2.0 Stable. Out now. Read more: v2.tauri.app/blog/tauri-20/

Tauri 2.0 Stable Release

The cross-platform app building toolkit

v2.tauri.app
1
2
120
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 👇
A screenshot of Doctave Studio 2.0: Doctave's upcoming editor for technical writing and docs-as-code.

ALT A screenshot of Doctave Studio 2.0: Doctave's upcoming editor for technical writing and docs-as-code.

1
1
130
Join the waitlist! doctave.com/doctave-studio

Doctave Studio 2.0 · Doctave

Doctave Studio is an editor designed for technical writing and docs-as-code. Build developer documentation portals with OpenAPI references, SDK docs, and Markdown guides.

doctave.com
37
Was writing a docstring for a #rustlang function, and the AI autocompleter just decided to straight up roast my code 😐
The AI autocompleted "This is a bit of a hack, but it's the best we can do right now."

ALT The AI autocompleted "This is a bit of a hack, but it's the best we can do right now."

1
97
Pontus Abrahamsson
@pontusab4 Sep 2024
I'll never write documentation again thanks to Cursor's @ codebase command
55
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

Using AI & LLMs in technical writing

We talk with Manny Silva, Head of Documentation at Skyflow, about V...

youtube.com
1
1
74
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!
1
4
90
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…

Markdown & Structured Authoring with Fabrizio Ferri-Benedetti

We sit down with Fabrizio Ferri Benedetti to chat about Markdown an...

youtube.com
1
2
7
1,090
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!
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.

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.

1
140
Slack helpfully transcribed a short video I uploaded to the @GetDoctave general channel. Unfortunately it doesn't seem to understand Finnish very well...
Transcript (auto-generated) Nik at 10:37 AM 0:00 Cord on this computer. 0:02 No, it's only a good recording and that's not emotionally go at the,, ok. 0:08 It's all on, you go to the cloud. 0:10 No, I guess I only have, I got, no, not about the hand. 0:12 I. 0:14 locale locale St io. 0:16 Ah, ok. 0:18 Moda, ma non lo è stata. 0:21 agora uma matéria da Casa não votada na próxima em Molenbeek. 0:26 mil Tratado Leina ここ で 雇っ た まあ もらっ て

ALT Transcript (auto-generated) Nik at 10:37 AM 0:00 Cord on this computer. 0:02 No, it's only a good recording and that's not emotionally go at the,, ok. 0:08 It's all on, you go to the cloud. 0:10 No, I guess I only have, I got, no, not about the hand. 0:12 I. 0:14 locale locale St io. 0:16 Ah, ok. 0:18 Moda, ma non lo è stata. 0:21 agora uma matéria da Casa não votada na próxima em Molenbeek. 0:26 mil Tratado Leina ここ で 雇っ た まあ もらっ て

1
37
Always found @twilio's docs to be world class. This was an interesting read. TL;DR: they've built a new custom docs platform on Next.JS, use Markdown/MDX for content, and a traditional docs-as-code authoring workflow. twilio.com/en-us/blog/new-er…

A New Era for Twilio's Documentation

Explore how Twilio transformed its API documentation using Docs as Code, Next.js, and MDX for a faster, more accessible, and unified developer experience.

twilio.com
2
87
One thing that LLMs cannot seem to get away from is using meaningless words like "streamlining", "elevating", and "synergy". I'm constantly prompting Claude/ChatGPT to not use corporate jargon, but it sneaks back all the time. Just seems really deeply ingrained 🤷
1
80
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.
Zeno Rocha
@zenorocha2 Jul 2024
How to build a developer tool: 🏎️ Make it fast, then even faster 🔓 Make it extensible, no lock-in ⭐ Make it frictionless to get started ✨ Make the docs part of the product 🤝 Make it predictable, backward compatible
1
1
73
Sometimes regular Markdown code blocks aren't enough. So we made them better!
Doctave@GetDoctave2 Jul 2024
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
1
35
We're going to be adding multi-repository support at Doctave: letting you use content from multiple Git repositories to construct a single portal. An update to any of the repositories that make up your docs will update your site automatically, all while maintaining consistency
1
6
If you've dealt with this, I'd love to hear from you! My DMs are open 👀
1
5
Managing diagrams as text with the rest of your docs 🤌
Doctave@GetDoctave25 Jun 2024
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.
31
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).
Chris Frantz
@frantzfries17 Jun 2024
we removed the AI-powered search from our docs because it was unreliable and made up fake features still waiting for the production-grade llm that can reliably produce data without hallucinations long way to go
1
1
2
95
Some people in the comments in that thread are claiming this is a "skills issue", solvable by better prompting. I have my doubts. If you could actually solve LLM hallucinations reliably, you'd become one the most important people in AI overnight.
13
Load more