Post 3318861 by ekaitz_zarraga@mastodon.social
 (DIR) More posts by ekaitz_zarraga@mastodon.social
 (DIR) Post #3318860 by xiroux@kosmos.social
       2019-01-24T09:49:27Z
       
       0 likes, 0 repeats
       
       Do you remember I praises AWS for its documentation? I definitely retract from my words.
       
 (DIR) Post #3318861 by ekaitz_zarraga@mastodon.social
       2019-01-24T10:01:54Z
       
       0 likes, 0 repeats
       
       @xiroux I never understood your praise. Why? because I've seen the deeeeeeeeep
       
 (DIR) Post #3318862 by djsumdog@hitchhiker.social
       2019-01-24T10:04:06Z
       
       1 likes, 0 repeats
       
       @ekaitz_zarraga @xiroux Docs change everything. When I started using Python around 2003 I was in fucking hell. Years later I returned when they revamped all their docs and it was night and day; made things so much easier.
       
 (DIR) Post #3320585 by jordila@social.ingobernable.net
       2019-01-24T11:17:43Z
       
       0 likes, 0 repeats
       
       @djsumdog @ekaitz_zarraga @xiroux Documentation ... Is Code ?
       
 (DIR) Post #3320633 by djsumdog@hitchhiker.social
       2019-01-24T11:21:03Z
       
       0 likes, 0 repeats
       
       @jordila @ekaitz_zarraga @xiroux So that's one of the interesting things that is changing .. Stack Overflow helps fill the gaps, give a lot of examples for some of the more complex or common but odd problems. Devs often look at SO questions first since they tend to be more specific than official docs. But also, better auto-documentation comments (Javadocs, Scaladocs, Spinx in Python) helps build the code/docs together. Elixir lets you run tests based on the examples you show in the code docs!
       
 (DIR) Post #3322661 by jordila@social.ingobernable.net
       2019-01-24T12:39:06Z
       
       0 likes, 0 repeats
       
       @djsumdog @ekaitz_zarraga @xiroux  ... just did it again ! I searched for "my-issue-here"... got onto the corresponding documentation page. And without having finished reading it ... nor tried to fully understand it. Jumped onto SO ... looking for a more concise answer ? Are we loosing the  capability of reading  carefully and patientlly  in the name of 'productivity' ?
       
 (DIR) Post #3330323 by lordbowlich@mastodon.social
       2019-01-24T16:59:22Z
       
       0 likes, 0 repeats
       
       @djsumdog @ekaitz_zarraga @xiroux I'm still a little disappointed in Python's docs. It's a great language, but I wish they would be more expressive and add more examples in for the beginner. I mean compare Python's documentation for abs() vs PHP's:https://docs.python.org/3/library/functions.html#abshttps://secure.php.net/manual/en/function.abs.phpThe fact that PHP has example code for every function in it's standard lib is one of the things it did get right.