Documentation Improvement Initiative

[JN]

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.

I think one of these could be incorporated as an example, either 
Adam's or Ali's code:

https://forum.dlang.org/thread/cexeumxikeovazyotkfl@forum.dlang.org

I always use those when starting a new D networked project.