[dox] DDOX (was Re: Can we get a forum section devoted to documentation?)

2013-08-17 Thread Andre Artus
On Friday, 16 August 2013 at 19:32:41 UTC, Mr. Anonymous wrote: On Friday, 16 August 2013 at 19:27:58 UTC, Andre Artus wrote: On Friday, 16 August 2013 at 19:12:46 UTC, Mr. Anonymous wrote: On Friday, 16 August 2013 at 18:12:57 UTC, Andre Artus wrote: Is there a way to break the pages into a

Can we get a forum section devoted to documentation?

2013-08-16 Thread Andre Artus
I would like to contribute to the D ecosystem, but as I'm still in the learning process I do not want to get my sticky fingers all over someones nice clean code. I have poured over the documentation and see that there are a few low-hanging fruit that I would like to pluck. So I have decided

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Dicebot
On Friday, 16 August 2013 at 16:07:59 UTC, Andre Artus wrote: I would like to contribute to the D ecosystem, but as I'm still in the learning process I do not want to get my sticky fingers all over someones nice clean code. I have poured over the documentation and see that there are a few

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Mr. Anonymous
On Friday, 16 August 2013 at 16:07:59 UTC, Andre Artus wrote: I would like to contribute to the D ecosystem, but as I'm still in the learning process I do not want to get my sticky fingers all over someones nice clean code. I have poured over the documentation and see that there are a few

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Craig Dillabaugh
On Friday, 16 August 2013 at 16:07:59 UTC, Andre Artus wrote: I would like to contribute to the D ecosystem, but as I'm still in the learning process I do not want to get my sticky fingers all over someones nice clean code. I have poured over the documentation and see that there are a few

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Andrei Alexandrescu
On 8/16/13 9:22 AM, Dicebot wrote: On Friday, 16 August 2013 at 16:07:59 UTC, Andre Artus wrote: I would like to contribute to the D ecosystem, but as I'm still in the learning process I do not want to get my sticky fingers all over someones nice clean code. I have poured over the

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread H. S. Teoh
On Fri, Aug 16, 2013 at 06:29:40PM +0200, Craig Dillabaugh wrote: On Friday, 16 August 2013 at 16:07:59 UTC, Andre Artus wrote: I would like to contribute to the D ecosystem, but as I'm still in the learning process I do not want to get my sticky fingers all over someones nice clean code. I

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Dicebot
On Friday, 16 August 2013 at 16:36:16 UTC, Andrei Alexandrescu wrote: Just use this forum and plant e.g. [dox] in the title. Andrei Why prefer less structured and inconvenient approach to an organized one? :) digitalmars.D is not that quite these days and discussing formal spec definitions

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Wyatt
On Friday, 16 August 2013 at 16:53:47 UTC, H. S. Teoh wrote: +1. /snip s/\+1/\+2/ to everything. Might encourage me to get back to my own doc stuff. -Wyatt

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Andrei Alexandrescu
On 8/16/13 10:12 AM, Dicebot wrote: On Friday, 16 August 2013 at 16:36:16 UTC, Andrei Alexandrescu wrote: Just use this forum and plant e.g. [dox] in the title. Andrei Why prefer less structured and inconvenient approach to an organized one? :) digitalmars.D is not that quite these days and

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Suliman
On Friday, 16 August 2013 at 16:07:59 UTC, Andre Artus wrote: I would like to contribute to the D ecosystem, but as I'm still in the learning process I do not want to get my sticky fingers all over someones nice clean code. I have poured over the documentation and see that there are a few

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Dicebot
On Friday, 16 August 2013 at 17:41:19 UTC, Andrei Alexandrescu wrote: The converse risk is balkanization. We already have subgroups that are effectively dead, for which similar arguments were made in the past. Problem with current subgroups is that they are created on topic basis, not to

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Andrei Alexandrescu
On 8/16/13 10:56 AM, Dicebot wrote: On Friday, 16 August 2013 at 17:41:19 UTC, Andrei Alexandrescu wrote: The converse risk is balkanization. We already have subgroups that are effectively dead, for which similar arguments were made in the past. Problem with current subgroups is that they are

Re: Can we get a forum section devoted to documentation? [dox]

2013-08-16 Thread Andre Artus
H. S. Teoh wrote: Most Phobos modules suffer from this problem. The first paragraph often just says something to the effect of this is module X (we already know that) and it contains Y, Z, W (we can see that already). Very unhelpful. We need descriptions of: 1) What: what this module does --

Re: Can we get a forum section devoted to documentation? [dox]

2013-08-16 Thread Andre Artus
On Friday, 16 August 2013 at 18:09:04 UTC, Andrei Alexandrescu wrote: On 8/16/13 10:56 AM, Dicebot wrote: On Friday, 16 August 2013 at 17:41:19 UTC, Andrei Alexandrescu wrote: The converse risk is balkanization. We already have subgroups that are effectively dead, for which similar arguments

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Dicebot
On Friday, 16 August 2013 at 18:09:04 UTC, Andrei Alexandrescu wrote: The argument is built from a mistaken angle. Thinking of doing some work on docs in the future, let's create a group for docs! Things should happen organically, i.e. creating a specialized group should follow a need

Re: Can we get a forum section devoted to documentation? [dox]

2013-08-16 Thread Wyatt
On 8/16/13 10:56 AM, Dicebot wrote: it. I'd probably favor deleting such obsolete groups (dtl, dwt, debugger?) but it is a different topic. Archive, don't delete. On Friday, 16 August 2013 at 18:25:02 UTC, Andre Artus wrote: I understand were you are coming from. And, while I currently feel

Re: Can we get a forum section devoted to documentation? [dox]

2013-08-16 Thread Mr. Anonymous
On Friday, 16 August 2013 at 18:12:57 UTC, Andre Artus wrote: Is there a way to break the pages into a more of a hierarchy, so that documentation for each module doesn't have to be on one page? Perhaps a DDOC Section could indicate the category? Are you familiar with DDOX?

Re: Can we get a forum section devoted to documentation? [dox]

2013-08-16 Thread Andre Artus
On Friday, 16 August 2013 at 19:12:46 UTC, Mr. Anonymous wrote: On Friday, 16 August 2013 at 18:12:57 UTC, Andre Artus wrote: Is there a way to break the pages into a more of a hierarchy, so that documentation for each module doesn't have to be on one page? Perhaps a DDOC Section could

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Jonathan M Davis
On Friday, August 16, 2013 10:41:19 Andrei Alexandrescu wrote: The converse risk is balkanization. We already have subgroups that are effectively dead, for which similar arguments were made in the past. Plus, if one of the main complaints with regards to the documentation is that only a few

Re: Can we get a forum section devoted to documentation? [dox]

2013-08-16 Thread Andre Artus
On Friday, 16 August 2013 at 18:41:57 UTC, Wyatt wrote: On 8/16/13 10:56 AM, Dicebot wrote: it. I'd probably favor deleting such obsolete groups (dtl, dwt, debugger?) but it is a different topic. Archive, don't delete. On Friday, 16 August 2013 at 18:25:02 UTC, Andre Artus wrote: I

Re: Can we get a forum section devoted to documentation? [dox]

2013-08-16 Thread Mr. Anonymous
On Friday, 16 August 2013 at 19:27:58 UTC, Andre Artus wrote: On Friday, 16 August 2013 at 19:12:46 UTC, Mr. Anonymous wrote: On Friday, 16 August 2013 at 18:12:57 UTC, Andre Artus wrote: Is there a way to break the pages into a more of a hierarchy, so that documentation for each module

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Andre Artus
On Friday, 16 August 2013 at 19:29:46 UTC, Jonathan M Davis wrote: On Friday, August 16, 2013 10:41:19 Andrei Alexandrescu wrote: The converse risk is balkanization. We already have subgroups that are effectively dead, for which similar arguments were made in the past. Plus, if one of the

[dox] List of Phobos documentation improvement candidates (Was: Re: Can we get a forum section devoted to documentation? [dox])

2013-08-16 Thread H. S. Teoh
On Fri, Aug 16, 2013 at 08:25:00PM +0200, Andre Artus wrote: On Friday, 16 August 2013 at 18:09:04 UTC, Andrei Alexandrescu wrote: [...] Things should happen organically, i.e. creating a specialized group should follow a need substantiated by increased volume of specialized discussion in the

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Jonathan M Davis
On Friday, August 16, 2013 21:57:01 Andre Artus wrote: It is disheartening to think that the people with potential for the most valuable contributions or insight will be avoiding discussions regarding the documentation. But I fear you are correct. There's a difference between avoiding

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Andre Artus
On Friday, 16 August 2013 at 17:45:35 UTC, Suliman wrote: On Friday, 16 August 2013 at 16:07:59 UTC, Andre Artus wrote: I would like to contribute to the D ecosystem, but as I'm still in the learning process I do not want to get my sticky fingers all over someones nice clean code. I have

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Andre Artus
On Friday, 16 August 2013 at 20:12:20 UTC, Jonathan M Davis wrote: On Friday, August 16, 2013 21:57:01 Andre Artus wrote: It is disheartening to think that the people with potential for the most valuable contributions or insight will be avoiding discussions regarding the documentation. But I

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread H. S. Teoh
On Fri, Aug 16, 2013 at 04:12:11PM -0400, Jonathan M Davis wrote: On Friday, August 16, 2013 21:57:01 Andre Artus wrote: It is disheartening to think that the people with potential for the most valuable contributions or insight will be avoiding discussions regarding the documentation. But I

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread H. S. Teoh
On Fri, Aug 16, 2013 at 10:24:55PM +0200, Andre Artus wrote: On Friday, 16 August 2013 at 17:45:35 UTC, Suliman wrote: On Friday, 16 August 2013 at 16:07:59 UTC, Andre Artus wrote: I would like to contribute to the D ecosystem, but as I'm still in the learning process I do not want to get my

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Andre Artus
On Friday, 16 August 2013 at 20:12:20 UTC, Jonathan M Davis wrote: On Friday, August 16, 2013 21:57:01 Andre Artus wrote: It is disheartening to think that the people with potential for the most valuable contributions or insight will be avoiding discussions regarding the documentation. But I

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread H. S. Teoh
On Fri, Aug 16, 2013 at 10:52:11PM +0200, Andre Artus wrote: [...] I just noticed when posting my previous reply to you that it connected to an NNTP server (I normally context switch on anything that takes more than a fraction of a second, so I have not seen it before). So I guess that many

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Andre Artus
On Friday, 16 August 2013 at 20:42:28 UTC, H. S. Teoh wrote: On Fri, Aug 16, 2013 at 10:24:55PM +0200, Andre Artus wrote: On Friday, 16 August 2013 at 17:45:35 UTC, Suliman wrote: On Friday, 16 August 2013 at 16:07:59 UTC, Andre Artus wrote: I would like to contribute to the D ecosystem, but as

Re: [dox] List of Phobos documentation improvement candidates (Was: Re: Can we get a forum section devoted to documentation? [dox])

2013-08-16 Thread Andre Artus
On Friday, 16 August 2013 at 20:03:10 UTC, H. S. Teoh wrote: On Fri, Aug 16, 2013 at 08:25:00PM +0200, Andre Artus wrote: On Friday, 16 August 2013 at 18:09:04 UTC, Andrei Alexandrescu wrote: [...] Things should happen organically, i.e. creating a specialized group should follow a need

Re: Can we get a forum section devoted to documentation?

2013-08-16 Thread Jonathan M Davis
On Friday, August 16, 2013 14:04:48 H. S. Teoh wrote: Actually, there are several things going on here: the forums themselves are hosted on NNTP servers, but IIRC very few members actually use NNTP directly. Instead, some proportion use the SMTP mailing list gateway (which runs mailman, which

Re: [dox] List of Phobos documentation improvement candidates (Was: Re: Can we get a forum section devoted to documentation? [dox])

2013-08-16 Thread H. S. Teoh
On Fri, Aug 16, 2013 at 11:23:28PM +0200, Andre Artus wrote: On Friday, 16 August 2013 at 20:03:10 UTC, H. S. Teoh wrote: [...] http://dlang.org/phobos-prerelease/index.html [...] There is a script running on the page you linked to that is making my browser misbehave. It's probably not

Re: [dox] List of Phobos documentation improvement candidates (Was: Re: Can we get a forum section devoted to documentation? [dox])

2013-08-16 Thread Jonathan M Davis
On Friday, August 16, 2013 15:43:39 H. S. Teoh wrote: And maybe then, I might actually turn on JS for dlang.org again. Or not, depending on whether that ugly unreadable blob of links at the top of every Phobos page is still there. Sigh... the things you have to do these days to make the web