Has anyone told them they can probably use AI to search for opportunities for lawsuits?
Has anyone told them they can probably use AI to search for opportunities for lawsuits?
Hmmmm, I locked an open door…
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.
Didn’t downvote you but I’m guessing that’s covered by “Tea-ville” which could be why.
Government employee makes mistake, other employee corrects mistake, innocent family suffers minor inconvenience. Stay tuned for more.
Come on, we can’t replace him with something more competent
Free me from this flesh, brother
You should watch Johnny Got His Gun if you haven’t. Not quite as extreme but kind of similar theme.
Nonono you’re not supposed to have principles, you’re supposed to just pick sides instead otherwise ‘what about USA’ won’t work as a gotcha. Just think of the poor tankies, whatabout USA is all they have, would you really tankie that away from them?
Of course they do. That’s what happens when you invade someone, the someone you invade also hits back at you.
That’s not that good, I can do that on a good day if I’m really hungry.
Saddam has some incredible crush resistance, we should start making entire submarines out of whatever material that is.
Your resume really stood out to us but we’ve heard some disturbing allegations of misconduct regarding your treatment of rocks we wanted to give you the opportunity to address.
It’s not that I don’t like your tone, I’m always down for a sarcastic quip. What I don’t like is dishonest people. You must think we’re all incredibly stupid if you expect anyone to believe your intent was to help by pointing out the upvote button.
I do admire your confidence, however misplaced, and your commitment to embodying your username though.
I really hope you’re not suggesting that you honestly think someone didn’t know about the upvote button? What a silly thing to imply that your sarcastic comment was supposed to be in some way actually helpful to someone.
You know if you don’t think a comment adds to the discussion there’s a purpose built button for you to express that exact sentiment? It’s right below the one you pointed out in your very helpful diagram.
Wait…is someone watching us?
Nooooooooo, nonono, absolutely not. Trust me honey I have very good eyesight and I can’t seAAAAAAHHHHH
And justice is simply the will of the stronger.