21
submitted 1 year ago* (last edited 1 year ago) by dontblink@feddit.it to c/programming@beehaw.org

Hi! I'm learning code: I've been doing a bit of JavaScript, and now i'm switching to TypeScript before going through frameworks.

One thing i'm quite missing is the possibility to have a personal documentation environment: something that let me write documentation on what i'm learning WHILE writing code and following my courses, using something like typedoc or javadoc.

I have been using Obsidian, that is good for markdown content, and i can generate docs with typedoc-markdown-plugin that i can then open on obsidian. However i would like to have both my code and my docs all togheter, not for a single project but for all the courses and little projects i'm doing, having it all togheter stored in one place, and possibly being able to share it as a portfolio in the future.

I don't specifically need to show the code in this environment, i just need the docs to be visible and to be pointing to the specific sections of the environment holding my code (wich can be github links like the ones that typedoc automatically add). I would like to have one directory for each project containing both my code and my docs.

Something like a programming digital garden! But integrated with tools that generate documentation from my code.

I've tried the typedoc-hugo-plugin to host a static docs website with Hugo, but it's not quite mantained and came with a lot of bugs, like broken links.

I'm trying to use Docusaurus and docusaurus-plugin-typedoc; it looks quite good, however i understood it is designed more to hold documentation for a single big project than for a series of small (learning oriented) projects. You need to configure each extra (more than one) docs folder to get it work properly, which is something i would avoid, if possible.

I love all the TSdoc standard thing, but i don't really know how to put everything togheter.

you are viewing a single comment's thread
view the rest of the comments
[-] CaptainJack42@discuss.tchncs.de 6 points 1 year ago

There is a vim plugin called vimwiki which is pretty much what you're looking for I think, but if you're not using (neo)vim this won't make much sense I guess. Other than that I'd probably just set up a GitHub gist or repo with your doc stuff

this post was submitted on 29 Jul 2023
21 points (100.0% liked)

Programming

10 readers
1 users here now

All things programming and coding related. Subcommunity of Technology.


This community's icon was made by Aaron Schneider, under the CC-BY-NC-SA 4.0 license.

founded 1 year ago
MODERATORS