Re: "Getting involved" on dlang.org?

2015-12-03 Thread Chris via Digitalmars-d
On Wednesday, 2 December 2015 at 21:46:39 UTC, Andrei Alexandrescu wrote: There is awareness. Good documentation is something we know we need and is an ideal to live into. Problem is prioritizing. I must be spending cumulatively a couple of hours everyday just deciding what to work on next.

Re: "Getting involved" on dlang.org?

2015-12-02 Thread Adam D. Ruppe via Digitalmars-d
On Wednesday, 2 December 2015 at 10:26:09 UTC, Chris wrote: Again, as I said to bachmeier (the name sounds Bavarian, btw), if the system is so complicated, there's something wrong. yeah. I think it is a huge pain to contribute to the web site, though it is a lot better than it used to be, it

Re: "Getting involved" on dlang.org?

2015-12-02 Thread bachmeier via Digitalmars-d
On Wednesday, 2 December 2015 at 15:35:23 UTC, Adam D. Ruppe wrote: On Wednesday, 2 December 2015 at 10:26:09 UTC, Chris wrote: Again, as I said to bachmeier (the name sounds Bavarian, btw), if the system is so complicated, there's something wrong. yeah. I think it is a huge pain to

Re: "Getting involved" on dlang.org?

2015-12-02 Thread Chris via Digitalmars-d
On Wednesday, 2 December 2015 at 16:22:32 UTC, bachmeier wrote: Setup and maintenance is one thing. Another is having to learn Git if you don't already know it. Another is that there is no guide for contributing to the documentation. I didn't know lines are supposed to be no more than 80

Re: "Getting involved" on dlang.org?

2015-12-02 Thread NX via Digitalmars-d
On Wednesday, 2 December 2015 at 16:22:32 UTC, bachmeier wrote: Another is that there is no guide for contributing to the documentation. I didn't know lines are supposed to be no more than 80 columns. Actually there is such documentation about it but guess what? It's hidden -like many other

Re: "Getting involved" on dlang.org?

2015-12-02 Thread Chris via Digitalmars-d
On Wednesday, 2 December 2015 at 19:06:05 UTC, NX wrote: On Wednesday, 2 December 2015 at 16:22:32 UTC, bachmeier wrote: Another is that there is no guide for contributing to the documentation. I didn't know lines are supposed to be no more than 80 columns. Actually there is such

Re: "Getting involved" on dlang.org?

2015-12-02 Thread bachmeier via Digitalmars-d
On Wednesday, 2 December 2015 at 16:54:56 UTC, Chris wrote: Good that we're talking about this now. Maybe the D leadership is not aware of this. Too many little annoyances that keep people from contributing. I'm going to guess that they are probably not aware of it. When you are the one that

Re: "Getting involved" on dlang.org?

2015-12-02 Thread bachmeier via Digitalmars-d
On Wednesday, 2 December 2015 at 21:45:55 UTC, Andrei Alexandrescu wrote: On 12/02/2015 04:22 PM, bachmeier wrote: On Wednesday, 2 December 2015 at 16:54:56 UTC, Chris wrote: Good that we're talking about this now. Maybe the D leadership is not aware of this. Too many little annoyances that

Re: "Getting involved" on dlang.org?

2015-12-02 Thread Chris via Digitalmars-d
On Wednesday, 2 December 2015 at 00:28:17 UTC, bachmeier wrote: The wiki page is pretty good right now. A link to it from the home page titled "Getting Involved" would do the trick. I don't think it's a good idea to put anything more than necessary on dlang.org, because it takes an act of

Re: "Getting involved" on dlang.org?

2015-12-02 Thread Chris via Digitalmars-d
On Wednesday, 2 December 2015 at 01:40:36 UTC, Adam D. Ruppe wrote: On Tuesday, 1 December 2015 at 21:01:17 UTC, Chris wrote: There is a lot of low hanging fruit, stuff that doesn't even require coding. You know, I just want to point out that writing documentation is actually really quite

Re: "Getting involved" on dlang.org?

2015-12-02 Thread Ola Fosheim Grøstad via Digitalmars-d
On Wednesday, 2 December 2015 at 01:40:36 UTC, Adam D. Ruppe wrote: BTW on the topic of documentation, I actually hired a junior programmer with no D experience to write some D tutorials with me. It was actually kinda eye opening to see all the things I take for granted being a stumbling block

Re: "Getting involved" on dlang.org?

2015-12-02 Thread bachmeier via Digitalmars-d
On Wednesday, 2 December 2015 at 21:22:43 UTC, bachmeier wrote: On Wednesday, 2 December 2015 at 16:54:56 UTC, Chris wrote: Good that we're talking about this now. Maybe the D leadership is not aware of this. Too many little annoyances that keep people from contributing. I'm going to guess

Re: "Getting involved" on dlang.org?

2015-12-02 Thread Andrei Alexandrescu via Digitalmars-d
On 12/02/2015 04:22 PM, bachmeier wrote: On Wednesday, 2 December 2015 at 16:54:56 UTC, Chris wrote: Good that we're talking about this now. Maybe the D leadership is not aware of this. Too many little annoyances that keep people from contributing. I'm going to guess that they are probably

"Getting involved" on dlang.org?

2015-12-01 Thread Chris via Digitalmars-d
Wouldn't it make sense to have "Getting involved" on the start page of dlang.org? Most OSS projects feature something like this on their homepages. In this way, if somebody feels like contributing to D, they get the how-to info straight away (preferably not on Wiki, but on dlang.org). There

Re: "Getting involved" on dlang.org?

2015-12-01 Thread bachmeier via Digitalmars-d
On Tuesday, 1 December 2015 at 21:01:17 UTC, Chris wrote: Wouldn't it make sense to have "Getting involved" on the start page of dlang.org? Most OSS projects feature something like this on their homepages. In this way, if somebody feels like contributing to D, they get the how-to info straight

Re: "Getting involved" on dlang.org?

2015-12-01 Thread Adam D. Ruppe via Digitalmars-d
On Tuesday, 1 December 2015 at 21:01:17 UTC, Chris wrote: There is a lot of low hanging fruit, stuff that doesn't even require coding. You know, I just want to point out that writing documentation is actually really quite hard... you need to know how it works, well enough to write about