Gem: dub about english HOT 7 OPEN

From @stonemaster on May 25, 2016 6:26

#27 must be implemented beforehand

from english.

From @stonemaster on May 25, 2016 20:41

@wilzbach suggestions:

how to create a static,dyn library using dmd
how to link a static, dyn library using dmd

from english.

Pinging regular contributors to dub @mdondorff @MartinNowak @grogancolin @p0nce @Geod24.
Has someone time to write a short gem (=tour section) about DUB and simple, common use cases?
The target audience is mostly newcomers to D.

FYI #27 is not needed for this (#27 is about the tour getting support for DUB packages).

from english.

From @Geod24 on August 15, 2016 1:15

Something along the lines of https://github.com/dlang/dub/wiki/Cookbook ?
It might need an update though.

from english.

Something along the lines of https://github.com/dlang/dub/wiki/Cookbook ?
It might need an update though.

That looks pretty nice already :)
One issue is that the tour currently allows only one example on the right hand side, so a good example that covers a couple of common cases is probably needed.
Btw for impression of other "Gems":

http://tour.dlang.org/tour/en/gems/uniform-function-call-syntax-ufcs
http://tour.dlang.org/tour/en/gems/subtyping

from english.

From @ZombineDev on August 15, 2016 9:51

@wilzbach count me in :P
I think we should do a series of chapters (like on vibe.d), because Dub is integral part of D's ecosystem. It's hard to (maybe even impossible) to do one example that would cover most common use cases.

Probably the right-hand side should be used for writing dub.sdl.

I think what most newcomers find missing is guide similar to Rust's Cargo guide and Haskell's wiki on writing Haskell programs. I think @mdparker and @redstar cover some of that in their books, but I think it would be nice to have it also on tour.

BTW, I think we should do two versions - one for people familiar with CLI tools (the Unix way), and one for people preferring GUIs and IDEs.

from english.

FYI, I'm working on a DUB Handbook. I'll be formally announcing it in a few weeks. I have no plans to publish it other than online as HTML and downloadable PDF. But I still think it's a great idea to add an introduction here.

from english.