On 3/10/14, 4:04 PM, Vladimir Panteleev wrote:
> It's still on my list... sorry it's taking this long. You're the only
> one who requested this feature, though. I can think of several
> improvements (some of which are in the pipeline) which I think would be
> more useful to the community overall, but if you think this is important
> I can bump it higher :)

Karma eh :o).

Andrei

On Monday, 10 March 2014 at 23:16:40 UTC, Brad Roberts wrote:
> A key required (imho) feature, the ability to edit after the fact.  The primary value that I see in any sort of embedded user input feature is the the most streamlined way of adding essentially bug reports about the page directly on the page.  Those reports should be acted upon and the page itself updated after which the report dropped.  The same with the essentially unmaintained wiki page that is linked to most of the dlang.org pages.
>
> I'm concerned about it becoming yet another forum for discussion.  Yet another place that needs to be monitored and maintained.  Something else that will grow stale.  Etc.  There's certainly value, and I've seen the value on other sites that support per-page user comments.  But there's a very real and very important cost that comes with it.

Any suggestions?

Edit-ability precludes NNTP/mailing-list mirroring, unless some shims like sending edits as replies are used.

I think that if we were to embed a wiki into the page directly, it would have be much less likely to bitrot due to higher visibility.

On Monday, 10 March 2014 at 15:08:07 UTC, Andrei Alexandrescu wrote:
> On 3/10/14, 7:00 AM, Dicebot wrote:
>> I still don't like disqus :)
>
> Are there better such systems available?

I don't like the very concept of comments integrated with the docs and can't accept PHP example as authority. It just feels very intrusive

wiki + stackoverflow + forum.dlang.org generate much more natural user documentation

> http://dlang.org/library

Looks nice!

I second the opinion that Disqus might have a better alternative. Its loading after the page was rendered looks clumsy, its style does not match that of dlang.org's... the whole thing is somehow out of place.

Ivan Kazmenko.

On 11 March 2014 14:09, Dicebot <public@dicebot.lv> wrote:

> On Monday, 10 March 2014 at 15:08:07 UTC, Andrei Alexandrescu wrote:
>
>> On 3/10/14, 7:00 AM, Dicebot wrote:
>>
>>> I still don't like disqus :)
>>>
>>
>> Are there better such systems available?
>>
>
> I don't like the very concept of comments integrated with the docs and can't accept PHP example as authority. It just feels very intrusive
>
> wiki + stackoverflow + forum.dlang.org generate much more natural user documentation
>
>
I don't like doc-integrated comments either.

A possible consequence is that people will simply stop improving the docs, because "workarounds" or extra explanations will be available in the comments.

Something like this happens in the AngularJS documentation, for example. There, the docs can be incomplete or even out of date, so you have to look at the comments.

Of course, if the docs are out of date regardless, this can be considered a good thing.

On 3/11/14, Dicebot <public@dicebot.lv> wrote:
> I don't like the very concept of comments integrated with the docs and can't accept PHP example as authority. It just feels very intrusive

Yeah, at some point there will be so many comments on a single page that it defeats the purpose. Comments which are stale (e.g. because the docs were fixed since then) should be removed, they're visual noise otherwise.

And disqus just like any other free online service is just a ticking time-bomb anyway. Pretty much all of these free online services die at some point.

On 3/11/14, 6:55 AM, Ivan Kazmenko wrote:
>> http://dlang.org/library
>
> Looks nice!
>
> I second the opinion that Disqus might have a better alternative. Its
> loading after the page was rendered looks clumsy, its style does not
> match that of dlang.org's... the whole thing is somehow out of place.

Unless something better comes about, we'll go with disqus. Sönke, are there styling options available?

Andrei

On Tue, 11 Mar 2014 11:12:51 -0400, Andrei Alexandrescu <SeeWebsiteForEmail@erdani.org> wrote:

> On 3/11/14, 6:55 AM, Ivan Kazmenko wrote:
>>> http://dlang.org/library
>>
>> Looks nice!
>>
>> I second the opinion that Disqus might have a better alternative. Its
>> loading after the page was rendered looks clumsy, its style does not
>> match that of dlang.org's... the whole thing is somehow out of place.
>
> Unless something better comes about, we'll go with disqus. Sönke, are there styling options available?

I want to stick my neck out and say that I love disqus *ducks*. But I don't know that it's what we should use in this instance. Disqus is great when you are having a live debate. New posts get loaded in real-time, votes are recorded in real-time, so it's very fluid.

But in this case, I don't see any fierce debates occurring on doc pages. Probably simple notes or "useful tricks" is what will appear there. A "live update" feature is pretty much overkill for such static discussion.

That being said, I've been on plenty of disqus sites, and they look different, act different, but have the same general look and feel.

An idea -- would it be possible to search links from the D forum, and post underneath the discussions that link to that doc page? Then have some sort of moderation so non-doc-related discussions don't clutter the page? Maybe even just first few sentences of the post, with a link to the D forum...

Then we don't have to have any kind of new interface for D posts, just a copy of what's already in discussion.

-Steve

On 3/10/14, Andrei Alexandrescu <SeeWebsiteForEmail@erdani.org> wrote:
> Consider it alpha quality. Please don't announce yet before we put it in good shape.
>
> https://github.com/D-Programming-Language/dlang.org/pull/516

I think on pages where we provide a cheat-sheet like in std.algorithm it's probably a good idea to remove the auto-generated list of functions, because it's essentially a duplicated list (and the cheat-sheet is better because it's humanly organized):

http://dlang.org/library/std/algorithm.html

On 3/11/14, 8:52 AM, Andrej Mitrovic wrote:
> On 3/10/14, Andrei Alexandrescu <SeeWebsiteForEmail@erdani.org> wrote:
>> Consider it alpha quality. Please don't announce yet before we put it in
>> good shape.
>>
>> https://github.com/D-Programming-Language/dlang.org/pull/516
>
> I think on pages where we provide a cheat-sheet like in std.algorithm
> it's probably a good idea to remove the auto-generated list of
> functions, because it's essentially a duplicated list (and the
> cheat-sheet is better because it's humanly organized):
>
> http://dlang.org/library/std/algorithm.html

Sönke, can we make the list generation optional?

Andrei