We build our products on a WeWeb/Xano stack and use Notion to document our products. At the moment there is no integration between WeWeb and our documentation. Documentation should be in sync with the actual implementation. Question now is - how to achieve that?
But first question would be - what is the go-to documentation tool in your opinion to manage and maintain the documentation of large software products?
I’m not sure how much you could use this on Xano, but I personally like using dbdocs.io for docs about the backend and dbdiagram.io for diagrams. You can then directly export the DBML to SQL and feed it to your Supabase project, this way I design my DB, and then just import it into Supabase and polish it, instead of filling everything manually in Xano for example. Then you have docs ready with dbdocs.
Hi @Broberto we’ve used DBDiagram before but we felt it lacked to ability to add context, more descriptive documentation (including examples, user stories, …).
Adding the DB schemes to Xano is the ‘easy’ part - it’s the complex logic that we’ve included (and that is every changing) that is a challenge to document (or maintain in documentation).
In my opinion anything can be a good documentation, you just need to make it good. It’s often not about the tool but about how you use it. I think notion would work. I also found https://obsidian.md/ but I haven’t had time to try it yet.