this post was submitted on 25 Nov 2023
1 points (100.0% liked)
Emacs
311 readers
2 users here now
A community for the timeless and infinitely powerful editor. Want to see what Emacs is capable of?!
Get Emacs
Rules
- Posts should be emacs related
- Be kind please
- Yes, we already know: Google results for "emacs" and "vi" link to each other. We good.
Emacs Resources
Emacs Tutorials
- Beginner’s Guide to Emacs
- Absolute Beginner's Guide to Emacs
- How to Learn Emacs: A Hand-drawn One-pager for Beginners
Useful Emacs configuration files and distributions
Quick pain-saver tip
founded 1 year ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
First I wouldn't concern myself too much with trying to explain what differentiates Emacs from an IDE. Life is too short to get into such debates. I can't really summarize why anyone should care about Emacs vs their IDE of choice.
For me what separates Emacs from vscode for instance is not the IDE aspects but the integration with the broader ecosystem. I'm a PM that works with technical and data heavy products. The details matter. I frequently walk through the pipelines and code of my product to understand how it is implemented by the team(s).
For example you can break my underlying product down into 3-4 large blocks of pipelines. Each pieline has 6-7 stages that mix Spark and other Python jobs. For each pipeline and stage I have my own little literate org file that points to code, has small samples of inputs and outputs, and generally speaking allows a non data engineering professional such as myself keep up with people that are far better and keeping this all in their head.
I write down questions as I do this to browse and/or raise with the team. I can, when questioned by our senior leadership, truly explain what it is our team did and the impact it had.
I can't do that with an IDE. I can't see an easy way to do that with any of the other note taking tools. I can't jump between code browsing, executing and writing as seamlessly anywhere else.
True. I kind of fake it in notion by linking to the file and line on github, but it isn't as good
Wow. I wish the PMs where I work understood data concepts to the depth you do.
For each pipeline and stage I have my own little literate org file
Damn, your verbose description checks all the boxes for a bullshit job.
Haha, why is that? To be clear that's not an expectation of the job. It's a self imposed process so that I understand wtf is going on. I enjoy it personally and feel it makes me better at what I do. Why do you think it's bullshit?
Lol
Bingo!
PM as in "project" or "product" manager? I've never experienced the former that wasn't an oxygen thief, but I've heard unicorns exist. My current product manager is quite good imo: shields engineers from idea ferries from all levels; talks to support and customers; has good track record of picking projects that successfully increases product adoption; etc. I wish our product manager took the time to understand our codebases as the op here does. I think with that knowledge it would be easier to convince the PM of the importance of certain refactors and why certain requests estimates are more difficult and or tedious that the PM expects.
Product. To be fair to project managers it's even more nebulous than our role. I have only worked with one project manager who was invaluable for my day to day. Sadly didn't get to work with her for long but would jump to do so again.
yes
Maybe a mixed role is the fabled unicorn "project" manager.
I'd rate this as a story about the benefits of literate programming, and emacs org-babel is certainly best-of-breed for that. A more mainstream workflow for it might be through Jupyter notebooks, but they have several deficiencies compared to org-babel, chief of which is that one can't present blocks out-of-order in Jupyter, but can do with org-babel-tangle. as far as I know, no literate-programming solution can pull code off disk and put it in a document (the anti-tangle direction), let alone update a doc when code is modified. It's doable (start with git-actions, maybe?) but difficult. The lack of anti-tangle stopped my team from adopting literate programming as a collaboration tool, but it's still great in the downward direction, i.e., from doc to code.
I'd agree but it goes a bit beyond. Each file has pointers to the source code that is locally checked out. Sure it's not dynamic (e.g. my comments and understanding of what's going on don't sync with the codebase as it changes), but it still allows me to keep a mental map of what's going on and where each piece of the pipeline resides.
It's a mixture of roam, literate programming and an IDE for me. E.g. I can easily spin up a vterm, ssh into a spark node and test some of the code if I don't understand what it's doing thoroughly or to check if something isn't doing what is intended.
In my use case, collaboration is not required. I'm doing it for me so there's no real cost to the documentation and understanding getting out of date. I find emacs an invaluable tool to deepen my understanding and test things in the codebase. An IDE just doesn't fit the bill in that regard.
I'm hoping Quarto will Jupiter - it's still not as flexible as org-babel but better version-controlled than Jupiter.
Pluto.jl apparently is reactive and immediately updates.