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 :)
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