Sales manager: Hi all, we are launching a new internal hackathon. Form up a team with the right expertise to help with address the problem statement and get going!

Me: what’s the problem statement?

Sales manager: you have to sign up first. There’s proprietary company info with our plans for next year involved. You have to agree to terms and conditions before continuing. Legal say so.

Me:

*signs up*,
*fills in docU-sign*,
*clicks through 3 other screens*

Ok let’s see this problem statement.

“What new and magical customer experience can you create and launch to win in our markets”

... that’s not a fucking problem statement ... and why the fuck does that require filling out a docu-sign form to see?

I REALLY fucking hate legal / sales people. Wasting everyone’s time.

seriously, odoo has the worst docu ever

Really? The docu of orchard (cms) is so bad that they refer to stackoverflow :>

"This is an easy task, call me when it's done"
5 months later
"well the test of senduser didn't pass"
Me: "this wasn't on the docu"
"oh, let me rewrite it"

!rant
I am doing an API for our training center to store the workouts of the athletes in relationship with the mental & physical load, as well as sleep and health.
How do you document your APIs?
BTW I am using laravel.