I've been using org-mode for about ten years to document moment-to moment progress on tasks. I'll give a basic summary of the problem, copy in significant commands and results as I run them, and ask the next questions to drive the next steps.
Some features that make Org useful for this:
- I'm clocked into the task so I can always jump to it easily, even as I hop around other emacs buffers
- supports code snippets with formatting in any language
- it's easy to add timestamped notes or write in free form
- can export the subtree to HTML or Markdown or Latex/PDF, to share with others
- GitLab will apply basic Org formatting (as with markdown), so I can share them directly just by pushing
- supports regex search across all agenda files, regardless of where they are. This is nice if, say, I know I had a similar issue with e.g. some docker command but don't remember which project it was on
Org is already 10 years old? It seems like yesterday that I was using Muse Mode. Then, seemingly overnight the muse discussion lists went very quiet because everyone switched to Org. I still have a bunch of notes in files that was created in Muse.
Not the OP but I use org-mode to write articles for my website and also to manage my dotfiles, this-- [http://abhirag.in/articles/org/i3_setup.html] is just an org-mode file exported to html, you can also see the literate dotfiles on that page, they have been generated using org-babel. I am also trying to setup a proper literate programming workflow using org-babel but that is still a work in progress. For a glimpse of what org-mode supports you can look at this this article of mine -- [http://abhirag.in/articles/org/custom_org_theme.html]. Hopefully these examples helped but I have only scratched the surface here, have a look at-- [http://orgmode.org/worg/org-tutorials/] and other stuff on the official website to find more information :)
Shameless plug: org-journal automatically creates one file per day, integrates with the calendar, implements searching within date ranges, and optionally rolls over TODO items to the current day.
Some features that make Org useful for this:
- I'm clocked into the task so I can always jump to it easily, even as I hop around other emacs buffers
- supports code snippets with formatting in any language
- it's easy to add timestamped notes or write in free form
- can export the subtree to HTML or Markdown or Latex/PDF, to share with others
- GitLab will apply basic Org formatting (as with markdown), so I can share them directly just by pushing
- supports regex search across all agenda files, regardless of where they are. This is nice if, say, I know I had a similar issue with e.g. some docker command but don't remember which project it was on