I know the proprietary D program is infesting everything, and that's really annoying.
It's like going back to the days where you had to do convoluted things like go to an ftp-server to download the docs-folder, or be subscribed to the mailing list at the time when the mail that contained the documentation was send.
For a time the most common thing to do was having a wiki-page and a forum to ask questions. That wasn't perfect but it was easy to navigate.
But enough of the complaining, what would be a good way to do documentation ?
Make every program self-documenting, including beginner tutorials ?
Make a more advance type of man-pages ?
Maybe it would be usefull to understand why the proprietary D got so popular in the first place. Take the essence of what made people use it and then enhance it but as a secure, spyware-free, open standard with a FOSS implementation.