Documentation Improvement Initiative

[bachmeier]

On Monday, 17 February 2020 at 18:48:25 UTC, Andre Pany wrote:
> On Monday, 17 February 2020 at 15:09:39 UTC, bachmeier wrote:
>> On Monday, 17 February 2020 at 12:16:26 UTC, Mike Parker wrote:
>>> This thread is a place to collect your documentation pain in 
>>> one place.
>>
>> I once tried to use std.socket:
>> https://dlang.org/phobos/std_socket.html
>>
>> Although it does link to a couple of examples, they don't have 
>> any explanation, so I gave up. An example where you're up and 
>> running in five minutes using Dub would be really nice. It's 
>> pretty clear that the documentation for std.socket assumes the 
>> user has learned sockets programming in another language 
>> before coming to D. We should remove that prerequisite.
>
> Adam D. Ruppe wrote a very good socket tutorial. You can find 
> it here 
> http://dpldocs.info/this-week-in-d/Blog.Posted_2019_11_11.html
>
> Kind regards
> Andre

That looks pretty good. It would have to be incorporated into our 
official docs though, at least by providing a link.