Only a sith deals in absolute paths.

I didn’t realise until I read that comment, your comment and the other comment about slash direction.

We used teams instead of slack at a place I used to work because it’s free. You know, kind of like how my coffee is free when I go to the window to collect it.

I dunno, job interviews I guess.

Aw man that really sucks. I moved to it back in the day after Postman got enshittified. The cycle continues I suppose

It’s been a while but insomnia used to be my go to

Good luck with your recovery, friend. Sorry that you burnt out in the first place too.

If you don’t mind sharing, how did you realise you were going through burnout and what are you doing to help yourself recover?

Preferably something geographically separated from the server as well in case of some kind of physically destructive event like a fire.

Don’t try and start these pronunciation debates online. It might seem fun but sooner or later the chickens will come home to Rust.

It’s called delegation

If you have the stones to try it

What a twist

What if you only have a nail?

Sounds like you need to add some sleep statements somewhere in your deployment scripts if you want to deploy in 10 seconds

Users are the acceptance testers.

No worries, sounds like you’re definitely on the right track with your approach.

In terms of the style of editor I don’t have a strong preference, I think the most important thing is discoverability which generally means putting docs where they are expected to be found and using whatever your team or org is using. Personally I have a slight preference for markdown mainly because it’s easy to version control, see who wrote what (so I can ask them questions) and use all the tools I’m used to that work well with plain text. Tools that use more WYSIWYG style can be good too though and many of them like Notion have the advantage of making it relatively easy to search across your entire companies documentation assuming everyone uses the one tool.

For my personal notes I use Logseq which I highly recommend. It’s a bit of both, markdown under the hood but with a simple editor that lets you focus on writing notes, tasks and links.

I would say as a new junior dev you are uniquely placed to help with this. Documentation tends to be written by people who know a lot about a thing and they try to imagine what might be useful for someone. Someone new coming in with a fresh perspective can help uncover assumed knowledge or missing leaps to make the documentation better. One of the common onboarding steps I’ve seen is to go back and update/improve the onboarding docs after you’ve just been onboarded for example.

I would say pick your battles though because documentation can be a never ending task and documents are almost always out of date shortly after they are written. Think about what would have saved you time or mental overhead if it was just written down and fix those first.

As far as organising and writing, every place is different and it can depend on the tools your org is using. In general I’d at least have links to relevant docs as close to where they might be needed as possible. Like how to set up and get up and running with a code base should probably be documented directly in the readme, or at least linked to if it’s overly complicated.

Hopefully that’s at least somewhat helpful. It’s definitely a problem basically everywhere I have worked though, you have to do what you can and not stress too much about it.

One might even say it’s an ExtremelyDrawnOutMethodNamesFactoryImpl

Almost certainly

The great thing about schema-less databases is you can put any old thing in there. The bad thing is at some point you have to get it back out again.