ddox-generated Phobos documentation is available for review

Vladimir Panteleev vladimir at thecybershadow.net
Mon Mar 10 16:48:04 PDT 2014


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.


More information about the Digitalmars-d mailing list