As per usual (being developers) we have left documentation until the last stage and I want to get some quality docs in there but don't see manually hacking a few web pages as the way forward.
Is there any product you would recommend to ease the process?
What is the current go-to documentation tool etc?
Thanks in advance.
I believe our developers at Reinforz uses a combination of notion and the codebase readme for that purpose. But for anything related to our product I usually store everything in notion, with correct formatting.
Thanks for your reply
As you're trying to speed up the process, I'd highly recommend just sticking with Notion. You do a lot with it before running into the need of more "Complex" solutions. Until you free up your time to fully migrate it into a more "professional" platform.
Thanks I will take a look at that one.
I've done exacry what you are not trying to do. The reason was that I wasn't in the mood to create docs on a place i would need to pay for a upgrade.
In my case the docs I create most of the time refers to something a bunch of customers has asked me more than once. So anything that can be shared quickly will work for them.
Usually (in my case) they just don't care how it looks. If they can read and understand they are fine.
I'm just iterating on what's the MVP even for docs for my side project. Minimum effort path.
Thanks for your reply, I can see your point and something to consider.
Been using gitbook and it works well.
Thanks
We've been using Archbee (YC S21) but there are a few negatives that we can't get past. An example of this is that your links change every time you reload your Open API spec. Another is that you can't add context to your API reference.
We are now looking at Mintlify (YC W22). The docs in their showcase are quite attractive and they've apparently solved for the gaps we've experienced with Archbee.
Thanks I will take a look
Totally feel this XD
I've done this a bunch and have tried to get away from it in my newer launches.
Right now for the AI I'm working on I'm using a combination of Coda + Airtable but this is for internal documentation.
For external documentation I've been using Coda or Notion as getting started points. If you search around or have internal documentation you may be able to use a ChatGPT like software to create starting version of these documents.
If not I recommend getting an assistant or someone who doesn't know the system to make some base documentation then you can refine the documentation with your expert/developer-level knowledge and a ChatGPT like or powered app.
I've seen a lot of businesses starting to use https://www.outseta.com/help-desk
But I think Notion could be provide a really awesome free setup.
Hope this helps!
Thanks for your comments, I will give those links a look.
No prob! I think a good way to get started is doing some website-like information architecture then from there you can better find a system that matches how you want it to work :)