Comment by buscoquadnary | Hacker News Reader

Comment by buscoquadnary | Hacker News Reader

I thought literate program was a farsical esoterica that was only born because of it's ivory tower surroundings, and would've stillborn had it come into the world any other way.

Until I found org-mode it really is world changing if I had picked up Doom Emacs for no other reason than org mode it would've been well worth it. I have now seriously considered trying to do literate program with org mode.

It's already seeped into every project I work on now has a notes.org where I keep kind of a stream of consciousness notes of what I am doing and copy and paste any code or command I have into it for future reference and it has already multipled my productivity.

I love org mode and for any person that is already a vimmer I recommend highly you pick up Doom Emacs and spend some time getting to become familiar with it, especially org mode and magit it really is world changing. I can't imagine ever going back.

I always liked the idea, but I was a pure math major, CS minor. Turns out I was better at programming that proof-writing, but Literate Programming is associated with the "Ivory Tower Academic Elite" because it really is handy.

Jupyter notebooks can provide a literate programming experience as well, but the plain-text experience of Org is something special.

These are exactly the types of things I wish I could get myself to spend the time to learn, but unless I can force myself to learn something as an actual part of building somethings that interests me, I'll never actually pick it up :(

Okay. In this case, the thing you’d be building is the documentation (and your own expertise). Does that interest you???

I actually don't hate writing docs to help other people, but can rarely motivate myself to write them for my own consumption, heh

I know what you mean. I was paid to write the API, and the documentation, which provided the necessary motivation to try to write it "literate". I had already been using `restclient` instead of Postman to interact with other APIs I work on. It was just a matter of being paid to take it to the next level.

Can you compare feature sets from magit to vim fugitive? I’ve always heard nice things about magit but nobody has verbalized it in comparison to what vim offers.

Not OP, but…

They're not in the same league, although this isn't a knock on fugitive as they have different goals.

If you don't want to try magit¹ itself, then vimagit² is a reasonable approximation within vim. It gives you the same kind of workflow as magit, but doesn't quite feel as polished IME.

¹ You don't need to be an emacs user to use magit, you can treat magit as a standalone application.

² https://github.com/jreybert/vimagit

Reply on news.ycombinator.com