english icon indicating copy to clipboard operation
english copied to clipboard

Gem: dub

Open wilzbach opened this issue 8 years ago • 7 comments

From @wilzbach on May 23, 2016 17:58

Idea: Give a short intro to dub, examples for different use-cases and ideally how to integrate with one's favorite build system.

Ping @s-ludwig.

Copied from original issue: stonemaster/dlang-tour#150

wilzbach avatar Aug 21 '16 14:08 wilzbach

From @stonemaster on May 25, 2016 6:26

#27 must be implemented beforehand

wilzbach avatar Aug 21 '16 14:08 wilzbach

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

wilzbach avatar Aug 21 '16 14:08 wilzbach

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).

wilzbach avatar Aug 21 '16 14:08 wilzbach

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.

wilzbach avatar Aug 21 '16 14:08 wilzbach

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

wilzbach avatar Aug 21 '16 14:08 wilzbach

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.

wilzbach avatar Aug 21 '16 14:08 wilzbach

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.

mdparker avatar Aug 21 '16 15:08 mdparker