• 0 Posts
  • 235 Comments
Joined 1 year ago
cake
Cake day: June 14th, 2023

help-circle
  • 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.






  • I think exercise selection is a pretty personal thing. There are going to be exercises you like that feel good and some that you don’t really get into. I’d say mix it up until you find a routine with exercises you enjoy or at least don’t mind that still hit the muscle groups that you want.

    I don’t really know how to answer the rest of it. If you find exercises you enjoy and they are helping you towards whatever your goals are I’d say who cares what people think but that’s just me.








  • Holy shit I hadn’t heard that story, that makes my blood boil. I would have contacted my embassy and turned that shit into an international incident. Also isn’t paying for someone’s flight in and refusing to let them fly back home some kind of trafficking charge?

    Anyway, I guess it’s easy for me to say because I could at worst afford to pay for my flight home in a pinch.






  • Aurenkin@sh.itjust.workstoAsklemmy@lemmy.ml*Permanently Deleted*
    link
    fedilink
    arrow-up
    17
    arrow-down
    1
    ·
    3 months ago

    Yeah I agree with this. The right thing is to try and learn from the situation, what could you specifically have done differently regardless of the behaviour of other people? I think in this situation if someone that’s not your manager is trying to give you work your best recourse is probably to go to your own manager rather than yelling at the person.

    As others have already said though, probably not a good idea to use anger or spite as a motivator for anything. Learn what you can from the situation and then do what’s best for you. In this case if this situation has blocked your progress and enjoyment at your current workplace it’s probably best to move on. Take what you learned and apply it going forward so you can better handle the situation if it comes back up again.