What about Jupyter Notebooks? If you are including code, that seems like a useful platform. https://jupyter.org/

Looks like I found some like quiver or cherrytree. Work is windows so quiver is out.

Markdown?

I guess it could be markdown but looking for more organization as this will be a rather large project of organizing the code

for example I could should the old code. Strip out any sql and place that into another block explaining what it does.

Have an explanation for the overall old function.

Then how to make it better.

Other would probably be reading this too.

Why not comments in the code? Open issues in a tracker for things to improve?

Have a look at “literate programming” and available tools for the concept.

I'm going through roughly 100 old vb6 functions that do god knows what and breaking them down into knew SQL queries ( we are restructuring the entire database, last one had no PK, FK, or normalization) I'm writing what I think the functions do and documenting what new tables should be used.

I also will be rewriting some of them but for now I'm doing this so when more team members join the project then can have the coles notes on each vb6 code breakdown.

Thanks for the suggestions.