www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - Beta of D language online tour

reply =?UTF-8?B?QW5kcsOp?= <Andre nospam.org> writes:
Hi,

After months of hard work (okay exaggerated) I'd like to announce 
the beta version of the D language online tour:

http://tour.dlang.io/

Thanks to Seb for providing the subdomain which now points to my 
testing server! And of course a big thank you to all 
contributors, proof readers and user suggestions in the past 
weeks!

* The content in the tour is now complete and contains all topics 
I wanted to touch initially
* Code examples can be compiled & run online - errors are shown 
graphically
* Layout has been adapted to numerous user suggestions and should 
give everyone a nice reading and experimenting experience

My goal would be to get the tour out during this month and have 
it open for public before DConf to use the extra attention to 
provide something for new users to experiment and play around 
with D. So I'd like to ask everyone to have a look at 
tour.dlang.io - and post issues, create pull requests & proof 
read.

The code is located here:

https://github.com/stonemaster/dlang-tour

The current version is running on a small testing server and I 
think we should start discussion on where this should be hosted 
for production use.

Thanks & regards,
André
Apr 09 2016
next sibling parent Andrej Mitrovic via Digitalmars-d <digitalmars-d puremagic.com> writes:
On 4/9/16, André via Digitalmars-d <digitalmars-d puremagic.com> wrote:

 Hi,

 After months of hard work (okay exaggerated) I'd like to announce
 the beta version of the D language online tour:

 http://tour.dlang.io/


This looks fantastic, awesome work! :)
Apr 09 2016
prev sibling next sibling parent reply Vladimir Panteleev <thecybershadow.lists gmail.com> writes:
On Saturday, 9 April 2016 at 17:12:44 UTC, André wrote:

 Hi,

 After months of hard work (okay exaggerated) I'd like to 
 announce the beta version of the D language online tour:

 http://tour.dlang.io/


Very nice!

How do you do the sandboxing?


 The current version is running on a small testing server and I 
 think we should start discussion on where this should be hosted 
 for production use.


I'm always open to hosting D-related projects (assuming the 
requirements are reasonable).
Apr 09 2016
parent reply =?UTF-8?B?QW5kcsOp?= <Andre nospam.org> writes:
On Saturday, 9 April 2016 at 20:19:05 UTC, Vladimir Panteleev 
wrote:

 On Saturday, 9 April 2016 at 17:12:44 UTC, André wrote:
 How do you do the sandboxing?


The sandboxing is done using Docker containers: 
https://github.com/stonemaster/dlang-tour-rdmd. It's a simple 
container that contains a recent DMD compiler and just runs rdmd 
on the user-provided source code. The Docker container is started 
with network disabled and a memory limit of 256MB. Additionally 
the dlang-tour app kills all containers which takes more than 20 
seconds to finish. This solution is quite light-weight and unless 
Docker has any significant security issue, should be quite safe.


 I'm always open to hosting D-related projects (assuming the 
 requirements are reasonable).


Oh that would be awesome. The current limit is 10 compilations in 
parallel, that means for the Docker sandboxes a total ram of 
2.5GB is needed. So for a start a server box of 4GB should be 
enough for now. But maybe there is some funding available from 
the D foundation?

Thanks & regards,
André
Apr 10 2016
next sibling parent reply Mark Isaacson <turck11 hotmail.com> writes:
Still awesome! Good work.

An easy(?) suggestion that would make this easier to browse: make 
the left/right arrow keys control advancing to the next page.
Apr 11 2016
parent =?UTF-8?B?QW5kcsOp?= <Andre nospam.org> writes:
On Monday, 11 April 2016 at 20:27:38 UTC, Mark Isaacson wrote:

 Still awesome! Good work.

 An easy(?) suggestion that would make this easier to browse: 
 make the left/right arrow keys control advancing to the next 
 page.


That should be fairly easy. Added an issue on GitHub for that: 
https://github.com/stonemaster/dlang-tour/issues/31

Thanks & regards,
André
Apr 12 2016
prev sibling parent reply Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> writes:
On 04/10/2016 12:43 PM, André wrote:

 On Saturday, 9 April 2016 at 20:19:05 UTC, Vladimir Panteleev wrote:

 On Saturday, 9 April 2016 at 17:12:44 UTC, André wrote:
 How do you do the sandboxing?


 The sandboxing is done using Docker containers:
 https://github.com/stonemaster/dlang-tour-rdmd. It's a simple container
 that contains a recent DMD compiler and just runs rdmd on the
 user-provided source code. The Docker container is started with network
 disabled and a memory limit of 256MB. Additionally the dlang-tour app
 kills all containers which takes more than 20 seconds to finish. This
 solution is quite light-weight and unless Docker has any significant
 security issue, should be quite safe.


 I'm always open to hosting D-related projects (assuming the
 requirements are reasonable).


 Oh that would be awesome. The current limit is 10 compilations in
 parallel, that means for the Docker sandboxes a total ram of 2.5GB is
 needed. So for a start a server box of 4GB should be enough for now. But
 maybe there is some funding available from the D foundation?

 Thanks & regards,
 André


Hey André, just tried to send you email via your fortress of security at 
http://www.steinsoft.net/contact. I got: 
object.Exception ../../../../.dub/packages/vibe-d-0.7.22/source/vi
e/mail/smtp.d(117): 
Failed to connect to SMTP server at 172.17.42.1 port 25

Could you please shoot me an email 
(http://erdani.com/index.php/contact/) so I can see how the Foundation 
can help the project with resources?


Thanks,

Andrei
Apr 12 2016
parent reply =?UTF-8?B?QW5kcsOp?= <Andre nospam.org> writes:
On Tuesday, 12 April 2016 at 15:07:20 UTC, Andrei Alexandrescu 
wrote:

 On 04/10/2016 12:43 PM, André wrote:

 Oh that would be awesome. The current limit is 10 compilations 
 in
 parallel, that means for the Docker sandboxes a total ram of 
 2.5GB is
 needed. So for a start a server box of 4GB should be enough 
 for now. But
 maybe there is some funding available from the D foundation?

 Thanks & regards,
 André


 Hey André, just tried to send you email via your fortress of 
 security at http://www.steinsoft.net/contact. I got: 
 object.Exception ../../../../.dub/packages/vibe-d-0.7.22/source/vi
e/mail/smtp.d(117): Failed to connect to SMTP server at 172.17.42.1 port 25

 Could you please shoot me an email 
 (http://erdani.com/index.php/contact/) so I can see how the 
 Foundation can help the project with resources?


Hi Andrei,

Oh thanks for finding the last bug on my website :-P

I just sent you an e-mail.

Thanks & regards,
André
Apr 12 2016
parent Andrei Alexandrescu <SeeWebsiteForEmail erdani.org> writes:
On 4/12/16 1:41 PM, André wrote:

 On Tuesday, 12 April 2016 at 15:07:20 UTC, Andrei Alexandrescu wrote:

 On 04/10/2016 12:43 PM, André wrote:

 Oh that would be awesome. The current limit is 10 compilations in
 parallel, that means for the Docker sandboxes a total ram of 2.5GB is
 needed. So for a start a server box of 4GB should be enough for now. But
 maybe there is some funding available from the D foundation?

 Thanks & regards,
 André


 Hey André, just tried to send you email via your fortress of security
 at http://www.steinsoft.net/contact. I got:
 object.Exception ../../../../.dub/packages/vibe-d-0.7.22/source/vibe/mail/smtp.d(117):
 Failed to connect to SMTP server at 172.17.42.1 port 25

 Could you please shoot me an email
 (http://erdani.com/index.php/contact/) so I can see how the Foundation
 can help the project with resources?


 Hi Andrei,

 Oh thanks for finding the last bug on my website :-P

 I just sent you an e-mail.


Great, thanks. The last bug is your contact form reads "Name:" and 
"Name:" instead of "Name:" and "Email:". -- Andrei
Apr 12 2016
prev sibling next sibling parent reply Vladimir Panteleev <thecybershadow.lists gmail.com> writes:
On Saturday, 9 April 2016 at 17:12:44 UTC, André wrote:

 Hi,

 After months of hard work (okay exaggerated) I'd like to 
 announce the beta version of the D language online tour:

 http://tour.dlang.io/


A few things I've noticed so far:

- Broken link: http://d-apt.source-forge.net/
- Link to redirect: http://www.dlang.org
- "D's standard build tool is dub." I think rdmd holds that 
title, Dub is the de-facto standard package manager.
- Would be nice to make the back/forward links bigger, so it's 
easier to click them. Perhaps put the name of the target page in 
the links.
- "Import's & Modules" - not a contraction, no apostrophe.
- The wording could use a do-over in places.

Perhaps put the content on GitHub to allow easily accepting 
contributions?
Apr 09 2016
next sibling parent reply ZombineDev <petar.p.kirov gmail.com> writes:
On Saturday, 9 April 2016 at 20:27:00 UTC, Vladimir Panteleev 
wrote:

 On Saturday, 9 April 2016 at 17:12:44 UTC, André wrote:

 Hi,

 After months of hard work (okay exaggerated) I'd like to 
 announce the beta version of the D language online tour:

 http://tour.dlang.io/


 A few things I've noticed so far:

 - Broken link: http://d-apt.source-forge.net/
 - Link to redirect: http://www.dlang.org
 - "D's standard build tool is dub." I think rdmd holds that 
 title, Dub is the de-facto standard package manager.
 - Would be nice to make the back/forward links bigger, so it's 
 easier to click them. Perhaps put the name of the target page 
 in the links.
 - "Import's & Modules" - not a contraction, no apostrophe.
 - The wording could use a do-over in places.

 Perhaps put the content on GitHub to allow easily accepting 
 contributions?


https://github.com/stonemaster/dlang-tour/tree/master/public/content/en
Apr 09 2016
parent Vladimir Panteleev <thecybershadow.lists gmail.com> writes:
On Sunday, 10 April 2016 at 05:38:09 UTC, ZombineDev wrote:

 https://github.com/stonemaster/dlang-tour/tree/master/public/content/en


Derp :) I see now it's in the OP post.
Apr 10 2016
prev sibling parent =?UTF-8?B?QW5kcsOp?= <Andre nospam.org> writes:
On Saturday, 9 April 2016 at 20:27:00 UTC, Vladimir Panteleev 
wrote:

 On Saturday, 9 April 2016 at 17:12:44 UTC, André wrote:

 Hi,


 A few things I've noticed so far:

 - Broken link: http://d-apt.source-forge.net/
 - Link to redirect: http://www.dlang.org
 - "D's standard build tool is dub." I think rdmd holds that 
 title, Dub is the de-facto standard package manager.
 - Would be nice to make the back/forward links bigger, so it's 
 easier to click them. Perhaps put the name of the target page 
 in the links.
 - "Import's & Modules" - not a contraction, no apostrophe.
 - The wording could use a do-over in places.

 Perhaps put the content on GitHub to allow easily accepting 
 contributions?


Thanks for the suggestions. Fixed them and the changes will be 
online soon. I will create an issue for the name of the 
next/previous section but I am unsure whether this will look good 
on mobile devices.

The content can be found here on GitHub: 
https://github.com/stonemaster/dlang-tour/tree/master/public/content. The nice
thing is that pull requests can be created automatically by just editing the
markdown files. So if you have suggestions or find errors you would make me a
big favour in creating a pull request :-)

Regard,
André
Apr 10 2016
prev sibling parent reply Bubba <bubba gmail.com> writes:
On Saturday, 9 April 2016 at 17:12:44 UTC, André wrote:

 Hi,

 After months of hard work (okay exaggerated) I'd like to 
 announce the beta version of the D language online tour:

 http://tour.dlang.io/
 ...


One thing that you should try to run: 
https://developers.google.com/speed/pagespeed/insights/
on your page.

that page shows where and how to fix your site for speed and 
better user experience. It even compress data like: Images/CSS/JS 
files where you can download and upload on your server.

The user experience for mobile is low there, and exactly what I 
feel while browsing.

Take a look there and try something like:

 media screen and (max-width:800px) { }

and

 media screen and (orientation:portrait) { }

For handling new behaviors on Mobile.

Overall this is nice resource for D.

Bubbasaur.
Apr 13 2016
parent =?UTF-8?B?QW5kcsOp?= <Andre nospam.org> writes:
On Wednesday, 13 April 2016 at 12:45:21 UTC, Bubba wrote:

 One thing that you should try to run: 
 https://developers.google.com/speed/pagespeed/insights/
 on your page.

 that page shows where and how to fix your site for speed and 
 better user experience. It even compress data like: 
 Images/CSS/JS files where you can download and upload on your 
 server.

 The user experience for mobile is low there, and exactly what I 
 feel while browsing.

 Take a look there and try something like:

  media screen and (max-width:800px) { }

 and

  media screen and (orientation:portrait) { }

 For handling new behaviors on Mobile.


Thank you for the suggestions! I'll have a look.
Regards,
André
Apr 13 2016