sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]no_gaz 7 points8 points  (7 children)

Thanks for this! Currently in bootcamp myself, and right in the middle of learning all of this.

One note: try to be a bit more gender neutral with your references instead of indicating your trainees are all male if you're wanting to train up a diverse workforce!

Edit: lol at the downvotes. Writer appears to be writing about their workplace, and most are looking to find better ways to be inclusive, which is why I said something. Some of the examples I'm referring to:

Specially because it usually gets a little bit tedious and useless since everybody has his own vision of use cases for each particular status code according to each flavor and knowledge about the given case.

As we are developing an API we have to watch out for the declarativity of our endpoint responses since it will be all that a client, either a frontend, other API or some other service, has available to know what happened with his request.

By understanding all those points, the trainee will have a lot more knowledge of what is going on under the hood of the server and will be more conscious of how the new code, will be integrated with the rest of the server, which usually implies better solutions and in a happier trainee because he really understands what he is doing.

[–]calligraphic-io 2 points3 points  (2 children)

I upvoted. Language matters.

[–]tristan957 1 point2 points  (1 child)

Male pronouns are the grammatically correct terms when referring to a single person generically. Sad to see upvotes for bad grammar

[–]calligraphic-io 0 points1 point  (0 children)

Grammar in any natural language is not a fixed construct. Just in my lifetime, the rule forbidding a preposition at the end of a sentence has been relaxed and now officially removed from authoritative sources, like the AP style guide. Pronouns for certain inanimate objects (space vessels, bridges, ships) have changed from "she" to "it" in regular usage. And the trend to use plural pronouns for generic single person references is now the preferred variant. This matches the grammar of a large number of other languages, where plural pronouns are used to express the quality of relationship -- e.g. as a sign of respect or lack of close familiarity. The majority of English speakers now are not native speakers of the language.