Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-31 Thread Martin Nowak via Digitalmars-d
On Friday, 23 January 2015 at 18:37:07 UTC, Martin Drašar wrote: Dne 23.1.2015 v 19:16 Andrei Alexandrescu via Digitalmars-d napsal(a): Both are nice: http://tour.golang.org/welcome/1 http://rustbyexample.com/ Or something along the lines of https://tryhaskell.org With possible integration

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-30 Thread Zach the Mystic via Digitalmars-d
On Saturday, 24 January 2015 at 18:59:52 UTC, H. S. Teoh wrote: On Sat, Jan 24, 2015 at 06:51:08PM +, Zach the Mystic via Digitalmars-d wrote: On Friday, 23 January 2015 at 21:56:59 UTC, H. S. Teoh wrote: On Fri, Jan 23, 2015 at 09:20:10PM +, Zach the Mystic via Digitalmars-d wrote:

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-26 Thread David Gileadi via Digitalmars-d
On 1/25/15 4:42 AM, Andrej Mitrovic via Digitalmars-d wrote: Here's another one: The search box allows selecting between: - Entire D Site - Library reference - Newsgroup archives But where's the Language spec option? It's missing due to how dlang.org is set up, and the limitations of

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-26 Thread H. S. Teoh via Digitalmars-d
On Mon, Jan 26, 2015 at 09:48:34AM -0700, David Gileadi via Digitalmars-d wrote: On 1/25/15 4:42 AM, Andrej Mitrovic via Digitalmars-d wrote: Here's another one: The search box allows selecting between: - Entire D Site - Library reference - Newsgroup archives But where's the Language

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-25 Thread Andrej Mitrovic via Digitalmars-d
On 1/23/15, aldanor via Digitalmars-d digitalmars-d@puremagic.com wrote: In continuing the series of rant posts about the website, this one will be about the documentation. Excellent points. In fact this kind of feedback is exactly what we need, to learn what it's like for someone new who just

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-24 Thread H. S. Teoh via Digitalmars-d
On Sat, Jan 24, 2015 at 06:51:08PM +, Zach the Mystic via Digitalmars-d wrote: On Friday, 23 January 2015 at 21:56:59 UTC, H. S. Teoh wrote: On Fri, Jan 23, 2015 at 09:20:10PM +, Zach the Mystic via Digitalmars-d wrote: [...] I have a basic suggestion on how to get started. Create a

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-24 Thread Zach the Mystic via Digitalmars-d
On Friday, 23 January 2015 at 21:56:59 UTC, H. S. Teoh wrote: On Fri, Jan 23, 2015 at 09:20:10PM +, Zach the Mystic via Digitalmars-d wrote: [...] I have a basic suggestion on how to get started. Create a Learning D button and put it on the menu at left on the front page. On the page it

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-24 Thread Zach the Mystic via Digitalmars-d
On Saturday, 24 January 2015 at 18:59:52 UTC, H. S. Teoh wrote: On Sat, Jan 24, 2015 at 06:51:08PM +, Zach the Mystic via Digitalmars-d wrote: Consider me destroyed! I mean to get started with it, but it'll take a week or so. A week is a short time as far as D pull requests go. :-P

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread aldanor via Digitalmars-d
On Friday, 23 January 2015 at 17:19:44 UTC, H. S. Teoh wrote: OTOH, do I hear the cry of a volunteer? ;-) (I'm only half-joking... the thing is, if nobody steps up to write said tutorial, it isn't gonna materialize. The rest of us are already busy enough with whatever it is we're

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread aldanor via Digitalmars-d
On Friday, 23 January 2015 at 17:03:17 UTC, aldanor wrote: Since we are the ones who generate the docs, we can totally do this (in a simplest way, bake in the markers into the ddoc and generate a javascript hashmap to trace back to them). I turns out that's exactly how it's done on the rust

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread H. S. Teoh via Digitalmars-d
On Fri, Jan 23, 2015 at 05:34:28PM +, aldanor via Digitalmars-d wrote: On Friday, 23 January 2015 at 17:19:44 UTC, H. S. Teoh wrote: OTOH, do I hear the cry of a volunteer? ;-) (I'm only half-joking... the thing is, if nobody steps up to write said tutorial, it isn't gonna materialize.

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread aldanor via Digitalmars-d
On Friday, 23 January 2015 at 18:17:30 UTC, H. S. Teoh wrote: Well, to be fair, the reason Ali's book is so detailed is because it's geared towards the newbie programmer who is learning how to program, possibly for the first time. So the pacing isn't really suited for an experienced programmer

dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread aldanor via Digitalmars-d
In continuing the series of rant posts about the website, this one will be about the documentation. This is a big one and no fixing css or pretty menus can amend this. I've recently started learning Rust myself (a few weeks ago) and despite the alpha state of both rustc and rust-lang.org

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread Andrei Alexandrescu via Digitalmars-d
On 1/23/15 9:03 AM, aldanor wrote: [NB] SUGGESTION: initiate work on an Official Guide and keep it up to date with the latest language features. That would be fantastic, and something that might be parallelizable as well. Here's a related thought: I wonder what it would take to put together

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread Andrei Alexandrescu via Digitalmars-d
On 1/23/15 10:09 AM, aldanor wrote: On Friday, 23 January 2015 at 18:00:13 UTC, Andrei Alexandrescu wrote: On 1/23/15 9:03 AM, aldanor wrote: [NB] SUGGESTION: initiate work on an Official Guide and keep it up to date with the latest language features. That would be fantastic, and something

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread Martin Drašar via Digitalmars-d
Dne 23.1.2015 v 19:16 Andrei Alexandrescu via Digitalmars-d napsal(a): Both are nice: http://tour.golang.org/welcome/1 http://rustbyexample.com/ Or something along the lines of https://tryhaskell.org With possible integration with D REPL. smime.p7s Description: Elektronicky podpis S/MIME

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread H. S. Teoh via Digitalmars-d
On Fri, Jan 23, 2015 at 05:03:15PM +, aldanor via Digitalmars-d wrote: [...] I personally see learning and documentation as two different classes of information. Learning resources might include tutorials, code examples, articles, books, whereas documentation would be a place for more

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread aldanor via Digitalmars-d
On Friday, 23 January 2015 at 18:00:13 UTC, Andrei Alexandrescu wrote: On 1/23/15 9:03 AM, aldanor wrote: [NB] SUGGESTION: initiate work on an Official Guide and keep it up to date with the latest language features. That would be fantastic, and something that might be parallelizable as

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread H. S. Teoh via Digitalmars-d
On Fri, Jan 23, 2015 at 06:30:04PM +, aldanor via Digitalmars-d wrote: On Friday, 23 January 2015 at 18:17:30 UTC, H. S. Teoh wrote: [...] I vote for ddoc / static generation. The site itself is static anyway, using client-side JS to do this seems to be overkill. You need both. What I

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread H. S. Teoh via Digitalmars-d
On Fri, Jan 23, 2015 at 09:20:10PM +, Zach the Mystic via Digitalmars-d wrote: [...] I have a basic suggestion on how to get started. Create a Learning D button and put it on the menu at left on the front page. On the page it links to, start by researching and listing every existing

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread Zach the Mystic via Digitalmars-d
On Friday, 23 January 2015 at 17:03:17 UTC, aldanor wrote: 1) D Learning This is the most problematic part. It's not even obvious where to start. Say I just landed on dlang.org via a google search and I want to find a quick user guide. I click D Reference (that seems the closest one to

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread Andrei Alexandrescu via Digitalmars-d
On 1/23/15 9:03 AM, aldanor wrote: In continuing the series of rant posts about the website, this one will be about the documentation. This is a big one and no fixing css or pretty menus can amend this. [snip] These insights are solid, sorry for not explicitly stating my position earlier.

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread weaselcat via Digitalmars-d
On Friday, 23 January 2015 at 17:03:17 UTC, aldanor wrote: On the bright side, D has a book. Or rather, it has THE book and a few more books, some of which are free and some are not. However, I wouldn't ever start to read a 500-page manuscript just in order to get acquainted with the language

Re: dlang.org redesign -- the state of documentation and learning resources [part 2]

2015-01-23 Thread Jerry Morrison via Digitalmars-d
After spending hours and hours in a breadth-first scan to learn me a D, I agree completely with the suggestions in this thread and I'm happy to help implement them. Caveats: I'm just now coming up to speed on D and I'm an engineer, not a tech writer. I think the biggest needs are: (1)