• 3 Posts
  • 20 Comments
Joined 1 year ago
cake
Cake day: June 2nd, 2023

help-circle
  • I don’t have a specific recommendation (I could just give out names of tools that seem to match your needs but I can’t really say I’ve used any), but in your place I’d reconsider your last requirement of “no connection to the DB”.

    In my view the best docs are the ones that take the least effort to keep up-to-date. Consider a tool that’s able to dynamically list and extract schemas from your existing tables and generate a nice HTML or diagram that can be used as a quick and up-to-date reference. That will require little or zero maintenance compared to a manual diagramming tool. So I’d start looking there.

    Depending on the project and usage I’d also consider exposing the database through an API. This makes documentation much easier too, as there are tools to auto generate API docs and you’ll decouple your DB schema + access from its usage, which has its own benefits.




















  • I feel the same. PDS has an open issue about the possibility of having the original comment in their editing feature, which would allow a “prepend” operation.

    Reddit pages are among the most useful for many search queries I have helped many others throughout the years. But Reddit as a company doesn’t deserve this leverage. For situations one really needs to read a deleted post or comment, with some luck they can see it in http://webarchive.org/ - that’s actually how I would see most posts that I needed after the June 12th blackout.