On Thursday, 24 December 2015 at 06:43:32 UTC, Andrei Alexandrescu wrote:
> Currently dlang.org has over 62KLOC of Ddoc source, so any significant surgery on it will be a large effort. Dropping ddoc means we'd need to use another templating engine (getting back to raw html would be too much trouble), and 10 people have 11 ideas about which template engine is used by "everyone".

Because using text editor that can auto complete html is too much to ask?
From what I saw most Ddoc is used to make simple html tags like $(P text) is translated to <p>text</p> so running few regex replace should fix that. Unless there are some macros that are more advanced.

> When the alternate documentation was introduced using vibe.d, my hope was that everybody would be all over it like a cheap white suit on rice

What skills web developers have: html/css, javascript, PHP, MySQL, Apache.

What skills are needed for dlang.org: CSS, javascript, make files, ddoc, D, dub, Vibe.d and its own way of generating html.

Not to mention that dlang has unique way of generating static html pages

You are not making it more accessible by adding one more technology that is not usually used for web development.

Here is how various languages are embedded in html
PHP: <?php code ?> or <? code ?>
Ruby on rails: <% code %>
Django(python): {% code %}
Hack: <?hh {code}
D: can`t.

Why cant D be used like all other web languages? (rhetorical question)

It would be nice if there were possibility of writing html with <?d code ?> in html and with structure like this:

<?d= include("header.dd");?>
<div>
<?d= content ?>
</div>
<?d=include("footer.dd");?>

and rdmd.dd could be found in folder views/Compilers&Tools/

this way any PHP, Ruby, Python, Hack developer could just look at dlang.org project and feel at home.

Todays system might not be terrible, but lack of documentation was a deal breaker for me. I wanted to fiddle with website layout and here how it went.

Welkam followed instructions and successfully generated html files. Why welkam needed to compile new dmd is not clear. Then welkam opened dlang.org folder. He saw 155 items and sighed. Anyway he wanted to edit documentation so the mess didnt bothered too much so he opened /home/welkam/D/dlang.org/dpl-docs/source/app.d. "I need to look at posix.mak to better understand how this page is built" - he said, but after looking at mak file he got more confused, because he doesnt understand make language. Welkam gave up and decided that editing html of one page would be easier for him and if he created something useful he would ask some help implementing it.

On Wednesday, 6 January 2016 at 11:35:12 UTC, anonymous wrote:
> Also check out http://d-ag0aep6g.rhcloud.com/ where I'm currently working on the implementation. It's a little different from the mockup, precisely because I'm trying not to drop features/content.

I am aware of your work. I will finish my "meditation" tomorrow and let you know

On 2016-01-06 15:35, welkam wrote:

> You are not making it more accessible by adding one more technology that
> is not usually used for web development.
>
> Here is how various languages are embedded in html
> PHP: <?php code ?> or <? code ?>
> Ruby on rails: <% code %>
> Django(python): {% code %}
> Hack: <?hh {code}
> D: can`t.
>
> Why cant D be used like all other web languages? (rhetorical question)
>
> It would be nice if there were possibility of writing html with <?d code
> ?> in html and with structure like this:
>
> <?d= include("header.dd");?>
> <div>
> <?d= content ?>
> </div>
> <?d=include("footer.dd");?>

https://vibed.org/templates/diet

-- 
/Jacob Carlborg

On Wednesday, 6 January 2016 at 14:35:13 UTC, welkam wrote:
> Here is how various languages are embedded in html
> PHP: <?php code ?> or <? code ?>
> Ruby on rails: <% code %>
> Django(python): {% code %}
> Hack: <?hh {code}
> D: can`t.
>

Good, everybody want to get away from this. This was a mistake.

On Wednesday, 6 January 2016 at 17:18:08 UTC, deadalnix wrote:
> Good, everybody want to get away from this. This was a mistake.

quoted for truth

On Wednesday, 6 January 2016 at 17:14:03 UTC, Jacob Carlborg wrote:
> https://vibed.org/templates/diet

I am aware of it, but that is one more technology to learn and how is it better?
How left one is more readable than right?
http://i.imgur.com/7KiehRI.png

On Thursday, 7 January 2016 at 02:46:30 UTC, welkam wrote:
> On Wednesday, 6 January 2016 at 17:14:03 UTC, Jacob Carlborg wrote:
>> https://vibed.org/templates/diet
>
> I am aware of it, but that is one more technology to learn and how is it better?
> How left one is more readable than right?
> http://i.imgur.com/7KiehRI.png

Well, this is biased because you only have one side with syntax highlighting.

On Thu, 07 Jan 2016 02:46:30 +0000, welkam wrote:

> How left one is more readable than right? http://i.imgur.com/7KiehRI.png

Tip: you can use Jade syntax highlighting for diet templates.

On Wednesday, 6 January 2016 at 11:35:12 UTC, anonymous wrote:
> Also check out http://d-ag0aep6g.rhcloud.com/

It is improving!

About the "Your code here" box: I accidentally had your page and dlang.org side-by-side with the same "Round floating point numbers" example, only yours had the inline comments stripped. I think the comments add a lot of value, and would advise to leave them in. I know this design looks bad when that box gets too high, and I think we would need a solution that allows examples with more lines without the length of the example affecting the layout of the page. Here are a few ideas (without knowing whether they would be doable or not):

  1. Box with fixed height and a slider to scroll the contents.
  2. Manually resizable box, much like the edit field in the online forums, with a slider when necessary.
  3. Box clipped to a fixed height (possibly with fade-out effect at the bottom). It could be expanding dynamically on mouse-over. The buttons would probably be best to have at the top.
  4. The drop-downs in the "Why D?" section work very well. Similarly, the box could be clipped as in 3 and expand on click. Encourage clicking on it by having a big "Play" button on it as you see on video's -- or something similar.

I hope you'll find a practical and attractive solution.

Bastiaan.

On 07.01.2016 10:02, Bastiaan Veelo wrote:
> About the "Your code here" box: I accidentally had your page and
> dlang.org side-by-side with the same "Round floating point numbers"
> example, only yours had the inline comments stripped.

Yeah, I also stripped some of its functionality (processing args instead of stdin), and I dropped the RPN calculator example entirely, because I couldn't get it down to acceptable size.

> I think the
> comments add a lot of value, and would advise to leave them in. I know
> this design looks bad when that box gets too high, and I think we would
> need a solution that allows examples with more lines without the length
> of the example affecting the layout of the page. Here are a few ideas
> (without knowing whether they would be doable or not):
>
>    1. Box with fixed height and a slider to scroll the contents.
>    2. Manually resizable box, much like the edit field in the online
> forums, with a slider when necessary.
>    3. Box clipped to a fixed height (possibly with fade-out effect at
> the bottom). It could be expanding dynamically on mouse-over. The
> buttons would probably be best to have at the top.
>    4. The drop-downs in the "Why D?" section work very well. Similarly,
> the box could be clipped as in 3 and expand on click. Encourage clicking
> on it by having a big "Play" button on it as you see on video's -- or
> something similar.

Thanks, the idea of making the example expandable somehow didn't occur to me.

However, my stance at the moment is that the intro examples should just be really short. The message is that you can do something useful or cool in just a couple lines of code. That means outright rejection of anything longer than, say, 20 lines, or maybe even just 15.