I moved from being a Web Developer to a Systems Engineer / Site Reliability Engineer / Platform Engineer (TL;DR; software engineering -> Infra / Cloud Architecture). During my year as a Web Developer, I used PyCharm as my main IDE. To be honest, it was a great experience. I loved live-debugging. As I was working on only one Django project all the time it was perfect. I learned a lot of Django by just digging into its mechanics and how it was dealing with the variables, views and all its goodness. However, when I moved to a pluridisciplinary job, that’s where I could feel this was not the right tool for everything. Even building python scripts. It was literally using an overpowered tool for a simple job. So I decided to move to Vim. I spent quite a lot of time to build a similar experience but with the tool that felt enough to have a confortable development experience.
Syntax highlighting, Syntax checkers, Linters and auto-completion when possible.
If you move away from something, you better have a reason, right? Or I guess that would be called madness or boredom… My main problem was that my setup was really flaky and the time consumed to produce it was quite crazy. As well for a “simple editor”, my vim was taking over 30/40 seconds to startup which can be quite irritating. So, I was still looking for a better alternative. I gave a shot to VS code, I just struggled as the navigation was not keyboard friendly. At the time, I was mainly in the terminal so having a dedicated app for the editor did not make sense and the editor is clearly made to be used with a mouse not keyboard first. So, I always ended up going back to vim. Until a colleague a year ago got a little bit pushy regarding emacs and spacemacs more particularly. I gave it a shot and after few times going back to vim, I finally moved over Spacemacs for good.
Pros:
- Spacemacs is a crowd configured “Emacs setup”
- Spacemacs is highly configurable
- Spacemacs can be used with Vim bindings ❤️
- Spacemacs bindings are mnemonic and discoverable
- Proper programming language to configure the editor (even if it’s Lisp sigh)
Cons:
- Learn how Emacs works
- Learn Lisp 😅
- Can get overwhelming with all the tools/packages Spacemacs provides
All good now? Well… I still spend an awful time configuring Spacemacs. First the learning curve was a bit stiff. Then learning all the packages. Then reading the packages and the layers (yeah I like to know how it works).
I’ll never go back to Vim though and that’s for sure. Now I discovered org-mode and I am using it quite intensively, I don’t feel I can move to any editor. I’ll write a post later on org-mode especially which I find the best way to take notes and keep your productivity to the roof.
There’s still some flaky elements like lsp integration, auto-completion which I am not quite about about but I started living without. It’s not like I am writing complicated software and if I have to dig inside the doc, it’s probably a good thing to force me read a bit.
So, should you stick to your massive IDE or try a simple text editor? Well.. If you want the later with the functionality of the first, you’re signing to a long journey into discovering the innards of your editor, being part of a community and starting contributing to it. If you simply want to gain in productivity with your editor, just learn the shortcuts. Glad mine is only usable with those 😂.
Cela va faire 5 ans que je suis dans l’industrie et j’ai joué avec pas mal d’éditeurs de code. Je dois vous l’avouer, c’est devenu un meme autour de moi vu que j’adore expérimenter tous les éditeurs qui existent. VS Code, Vim, Emacs, IntelliJ, PyCharm, etc… C’est chronophage. Comme le titre vous a sûrement mis la puce à l’oreille, cet article sera à propos de ma transition de Vim vers Spacemacs. J’ai passé 4 ans sur Vim avant de bouger sur Spacemacs. J’ai eu une année d’égarement où j’ai utilisé PyCharm malgrès les louanges quotidienne de la bête technique qui travaillait à côté de moi. Je suis sûr que vous avez déjà lu une multitude d’articles ayant comme sujet ”Pourquoi j’ai bougé de X à Y et voici pourquoi vous devriez faire de même.”. Je ne suis pas d’accord avec la pratique et clairement, si vous n’avez pas les mêmes besoins que l’auteur, changer va-t-il en valoir la peine? Malheureusement, il n’y a pas de meilleurs éditeurs. FIN. Je vais vous donner quand même les raisons de pourquoi j’ai switché. Peut-être que vous vous y retrouverez.
Je suis passé de Développeur Web à Ingénieur Systèmes / SRE / Ingénieur plateforme (bref sys. admin avec un peu de dev). Pendant mon année de Développeur web, j’ai utilisé PyCharm comme mon IDE principal. Pour être franc, j’ai eu une super expérience. J’ai adoré le debuggueur intégré. Comme je ne travaillais que sur un seul projet django, un IDE était parfait. J’ai appris énormément sur Django grâce à l’IDE en creusant comment Django fonctionnait. Cependant quand j’ai migré vers un travail pluridisciplinaire, c’est là que j’ai senti que PyCharm n’était pas l’outil pour mon taf de tous les jours. Clairement, c’est une usine à gaz et pour écrire de simples scripts ou changer du YAML, pas besoin d’un IDE. J’ai donc décidé de bouger sur Vim vu que je passais ma vie dans le terminal. La transition de PyCharm / IDEs de JetBrains vers Vim n’a pas été sans effort, je vous rassure tout de suite. De plus, configurer l’éditeur pour avoir un confort similaire aux IDEs m’a pris énormément de temps.
Syntax highlighting, Syntax checkers, Linters et auto complétion quand c’est possible.
Si vous fuyez quelque chose, vous devez avoir une raison. Mon problème avec Vim était que ma config était instable. Genre 15 outils différents pour faire tourner l’éditeur donc 15 outils à supporter et maintenir, un peu galère. De plus, pour un “simple éditeur”, Vim prennait quasiment 40 secondes pour démarrer. Donc je cherchais une alternative. À ce moment là, VS Code faisait pas mal de bruit, ”la nouvelle ère de Microsoft”, j’ai donc essayé l’éditeur. J’ai eu du mal. Avec Vim, j’avais pris l’habitude de naviguer un peu partout avec des raccourcis clavier. On ressent très vite que ce n’est pas le cas avec VS Code. Enfin oui, on peut. Mais avec l’intégration Vim, on est limité à naviguer seulement dans le code avec les raccourcis vim, pas l’éditeur entier. De plus, je passais mon temps dans le terminal, j’avais mon setup avec tmux + vim, je voulais juste un expérience similaire. Donc un éditeur qui peut tourner dans le terminal. Je suis resté sur Vim jusqu’à ce qu’un collègue, un peu insistant, me montre Spacemacs. J’ai essayé et après avoir retourné sur Vim plusieurs fois, j’ai enfin passé à Spacemacs pour de bon. Clairement la migration avait des avantages et inconvénients:
Pour:
- Spacemacs est une configuration d’Emacs configuré par la communauté
- Spacemacs est très configurable
- Spacemacs peut être utilisé avec les raccourcis Vim ❤️
- L’éditeur utilise un langage de programmation (même si c’est du Lisp… sigh)
- Les raccourcis de Spacemacs sont mnémonic et découvrable
Contre:
- Apprendre comment Emacs fonctionne
- Apprendre Lisp 😅
- On peut être vite dépassé par le nombre d’intégration et d’outils que Spacemacs contient
Si vous voulez essayer, c’est assez simple. Installez Emacs sur votre OS puis clonez Spacemacs dans `~/.emacs.d`. Je vous invite à changer la branche utilisée dans .emacs.d pour “develop” comme cette branche est plus maintenue que master et contient bien plus de fonctionnalités. Une fois emacs lancé, vous pouvez découvrir les raccourcis en pressant simplement “espace”. Vous aurez une présentation de tous les raccourcis disponibles. p pour projet, w pour window, b pour buffer, etc… Les raccourcis s’apprennent très rapidement car la plupart ne sont que les initiales de l’action que vous voulez faire. Vous voulez voir l’arborescence de ficher de votre projet? “project -> tree”: “Espace”+ “p”+ “t”. Facile.
Hum… Je passe toujours autant de temps sur ma configuration de Spacemacs. L’apprentissage de l’éditeur était un peu long mais j’ai gagné énormément en productivité. J’ai aussi appris Lisp et lu les “packages” de Spacemacs. Contribué à certains. Ça a été un sacré voyage mais je ne le regrette pas une seconde. De plus, en utilisant emacs en mode serveur, votre éditeur démarre en 2 secondes, c’est impressionant. Donc oui, c’est clairement mieux et je ne retournerai pas sur Vim, c’est sûr. De plus, j’ai découvert org-mode et je l’utilise avec ce blog et au taf. Je ne pense pas qu’un seul éditeur n’aura l’intégration qu’Emacs a pour org-mode. J’écrierai un article sur org-mode comme je commence à pas mal m’en servir.
Il y a toujours des éléments instables dans ma configuration comme l’intégration avec le Language Server Protocol. Je peux vivre de sans mais l’auto-complétion reste sympa à avoir. Ça me force à lire la documentation ce qui n’est probablement pas plus mal. Mais bon, n’oublions pas que la configuration de Spacemacs est toujours en “development” et que ce genre d’instabilité est attendue.
Donc devez-vous bouger sur Spacemacs ? Probablement pas, je suis quasiment sûr que votre éditeur peut être configuré pour vos besoins. Mon conseil à 2 francs: Apprenez les raccourcis clavier plutôt que de naviguer à la souris. Sinon, rejoingnez moi dans un voyage de configuration et de weekends perdus à maximiser votre productivité, genre perdre un dimanche aprem pour gagner 2 minutes la semaine. Non ? Personne ? Je comprends pas… 😂
Markdown is clearly programmers preferred (or at least most used) text format. By moving to Emacs, I got a bit curious on the documentation format used by the majority of the packages. This format is org. I read a bit about it and was blown away by what people were able to do with it.
So you might wonder, why bother creating a new markup / text format. The thing is Org mode has been around since the 2000. It has been created to follow some productivity workflow called “Get things done” by David Allen. I don’t think it would make much sense for someone to jump on org-mode without using Emacs. A bit of technology locking here unfortunately. Its main strength comes with the tooling around the language itself. Think about Markdown but with strong integration in your editor, generating calendars, todo lists, remainders and others.
So if you’re more the kind of person that likes everything in one place, that’s the way to go. If not, clearly not. Emacs will become a beast and you’ll never get out of it. Your choice.
There’s plenty of tutorial and guides to help you out. I don’t think it’s worth to repeat what’s been done so here’s some good links that helped me out:
My main advice to get started is to just create a all.org in a notes git repo and just start writing stuff you’ll need for later. How-to-s, Documentation, Meeting notes etc… Once you’ll get the syntax, you’ll naturally check what you can do with some org plugins and discover some powerful stuff.
Org-mode itself is just a markup language so it should not be too complicated to learn. However, its ecosystem is so massive, it can be tough to know where to start.
We said org-mode strength is the tooling made around its markup language. For instance, in org-mode and emacs, I can write some snippets and make them executable easily thanks to org-babel. That allows you to have some executable documentation (a bit like a juniper playbook). Which can be quite powerful if everyone is using emacs. No need of Makefile if you can run each steps directly from your README.org!
I love to track how I spend my time at work so I tend to use the pomodoro technic to catch that. Guess what, there’s an org extension for that, org-pomodoro. I put all my stuff to do in a all.org, run org-pomodoro, choose which task I am working on and bim, I have a timer set in Emacs and will get an alert once the pomodoro is finished. As well, it logs the time spent on each task so you can have aggregated data on the time spent for a specific item, pretty neat.
Now the main question is “That looks really promising but at work we use X and Y and Z to log work so I can’t introduce a new tool to the team!”. I am in the same position! However, you can collect data and convert them in org-mode with a lot of “external providers”. Using Jira? org-jira is there to grab the tasks you have to do. Using Trello? org-trello is there. There’s a lot more but you can grab data mostly anywhere and import them in your org setup.
Obviously, every single technology comes with its caveats. As said before, org-mode is locked to Emacs unfortunately, so people having a org-mode workflow are quite locked to Emacs. And vice-versa, you want to play with it? Definitely better in the editor. There’s some effort made to port the incredible Emacs ecosystem to other editors but it’ll never be the real thing.
It’s a bit problematic for the adoption of the technology. In my case, I can not use org-mode at work (or at least share my org stuff). No one is using emacs so no one will be able to parse those files / render them correctly and get any benefit from using that format.
Another point is that, you are adding layers / packages to your Emacs setup which means more configuration and testing which can be quite time consuming.
As well, the integrations are mainly single people side-projects and you can end up with outdated projects or not supporting your use case. If you’re brave enough, it’s your time to shine and implement what you want from those packages. Good luck with e-lisp though 😂.
Org-mode is a beautiful piece of software. Its markup is similar to markdown but includes way more functionalities when used in Emacs. The ecosystem of that language turns a simple file into a playbook, a project planner, an habit tracker, encrypted data and anything else you would think of! However, the fact that the ecosystem is tightly coupled to Emacs makes the adoption quite difficult and low even though its incredible capabilities. If you’re interested about org-mode, don’t hesitate and send me a tweet, if I receive a few, I might even write how I use org-mode.
Markdown est clairement le langage préféré des développeurs. En migrant sur Emacs, j’ai été surpris de constater que la documentation de nombreux plugins est écrite en “org”. J’ai lu rapidement à propos et été surpris par ce que l’on peut accomplir avec cette technologie.
Il se peut que vous vous demandiez, pourquoi créer un autre langage tel que markdown qui est devenu la référence. Il faut savoir que org a été créé dans les années 2000 afin de pouvoir utiliser les principes et méthodologies introduits par “Get things done” de David Allen.
De plus, je ne pense pas qu’il y ait beaucoup d’intérêts à bouger vers org-mode si vous n’utilisez pas Emacs. Toute la puissance de la technologie repose sur son ecosystème et intégration à Emacs. Il faut voir org-mode comme un markdown sous testostérones.
Si vous êtes le genre de personne qui aime avoir un système tout-inclus, org-mode et Emacs vont être parfait pour vous. Sinon pas trop. Emacs va se transformer en usine à gaz et vous n’en sortirez jamais. Comme vous le sentez.
Il y a beaucoup de tutos sur les internets qui vont vous expliquer mieux que moi comment écrire en org. Voici un tutoriel qui m’a beaucoup aidé:
Si je dois vous donner un conseil, commencez avec un seul fichier où vous regroupez toutes vos notes. Ça va vous permettre de découvrir l’écosystème d’org-mode. Rien que le besoin de créer des notes rapidement va vous introduire à org-capture (un systeme de template pour org-mode). Vouloir exécuter du code en local vous introduira à org-babel. Ajouter une sorte de gestion de projets vous incitera à utiliser les TODO et org-agenda.
Le langage en lui-même est équivalent à Markdown donc il ne devrait pas être trop compliqué à utiliser. Cependant son écosystème est tellement vaste qu’il peut être intimidant.
Comme dit précédemment, la force d’org-mode réside dans les outils construit autour du langage. Par exemple, avec org-mode et emacs, je peux écrire des snippets dans ma documentation et les exécuter directement depuis celle-ci. Plus besoin de Makefile quand on peut tout exécuter depuis la documentation.
Au travail, j’ai tendance à travailler sur 15 trucs en même temps et il peut être difficile de justifier pourquoi les tâches des gros projets n’ont pas avancées. Pour éviter ça et être productif au max, j’utilise principalement la technique pomodoro pour ça. Coup de bol, org-pomodoro me permet de choisir une des tâches que j’ai créé dans mes fichiers org et lancer un timer de 25min. Je recois une notification une fois fini et je peux faire une pause. De plus, je peux même aggréger les données de mes pomodoros sur une tâche pour voir le temps total passé dessus.
“Ok t’es gentil avec org-mode mais j’ai déjà X, Y et Z pour gérer mes projets, ma doc, mes notes, etc…” Je comprends, je suis dans la même situation. Il existe des “providers” qui vous permettent de synchroniser vos fichiers org depuis des sources externes. Trello, exchange, Jira, Google Calendar et bien d’autres. Ainsi vous pouvez tout modifier à partir de fichiers “org” et avoir, ainsi, un mode textuel pour tous ces éléments externes.
Forcémment, chaque technologie vient avec ces limitations. Comme énoncé précédemment, org-mode est principalement utilisable dans Emacs. Certaines personnes essayent de porter les extensions disponibles sur d’autres éditeurs mais je n’ai rien vu d’équivalents à celles d’Emacs.
Cette limitation est problématique pour l’adoption de la technologie. Dans mon cas, je ne peux pas partager mes fichiers orgs au travail. Personne n’utilise Emacs et donc ne verront pas l’utilité d’utiliser un format différent de Markdown.
De plus, chaque extension ajoutée à votre config ajoute de la complexité à votre setup. Toutes ces extensions doivent (pour la majorité) être configurée. Ce qui peut prendre pas mal de temps.
Pour finir, les intégrations sont principalement des projets personnel qui ont grande chance de ne pas être à jour ou être abandonné. Si vous êtes vraiment chaud, vous pouvez toujours utiliser votre talent inné de programmeur Elisp et supporter les projets dont vous avez besoin. Gros respect si vous faites ça.
Org-mode, c’est beau. Le langage en lui même ressemble à markdown mais ajoute bien plus de fonctionnalités une fois utilisé dans emacs avec son ecosystème. L’écosystème transforme un simple fichier en un playbook, un gestionnaire de projet, un gestionnaire d’habitudes, peut chiffrer vos fichiers et bien plus encore! Cependant, le fait que l’écosystème soit étroitement lié à Emacs fait que son adoption n’est pas si grande malgré toutes ces fonctionnalités. Si jamais la techno vous intéresse, n’hésitez pas à me pinger sur twitter et si le besoin se fait ressentir, j’écrierai peut-être un article sur mon usage d’org-mode. Sur ce, codez-bien!
This week I encountered an issue regarding some file permissions. As I feel I should have known this for a long time… So back to the basics.
I’m Jean-Loup Adde (nice to meet you 😄), a 27 year old software developer. I have a crush on all the technologies around the web, automation, and maybe too many others. I used to host all my stuff on specific VMs writting custom code. And recently I decided, screw that, why bothering with so many layers when you just want to write some posts in Markdown! So bye bye DBs, bye bye Web Frameworks, hello fully static generated website hosted on [netlify.com](https://netlify.com).
In case you’re wondering what tech I use for this blog, everything’s made with [hugo](https://gohugo.io/) using the [jane theme](https://en.xianmin.org/hugo-theme-jane/) that I changed a bit ([modifications here](https://github.com/juanwolf/hugo-theme-jane/tree/master)).
You’re currently at the v2 of my blog. At the beginning it was a django application that I wrote from scratch. To be honest it was an awesome challenge for me at the time (2014, student of master 1 in Software Engineering). I wrote everything from scratch, CSS, HTML, python. It was hard to say goodbye to the old version, it was like saying goodbye to an old friend or a younger version of myself. Weird, isn’t it?
Anyway as I was getting worried about the future, the time I could spend looking about these apps, I decided to move this blog to something in the ☁️, easy to add content to (which the django app was not) and where people would enjoy read articles (so nice UX experience). So here’s the v2, I hope you’ll enjoy it! If anything’s wrong or you dislike, PLEASE, let me know via [twitter](https://twitter.com/juan__wolf/) or opening an issue in [github](https://github.com/juanwolf/juanwolf.github.io/)