Release DUB 0.9.25, new logo and updated website design

Sönke Ludwig via Digitalmars-d-announce digitalmars-d-announce at puremagic.com
Mon May 23 10:09:16 PDT 2016


Am 23.05.2016 um 17:55 schrieb Luís Marques:
> On Sunday, 22 May 2016 at 19:36:39 UTC, Sönke Ludwig wrote:
>> In preparation to that, it also received a thorough optical overhaul.
>> The newly designed logo (which has appeared in some other spots
>> already) has been integrated on the package registry, and the site
>> style has been adjusted to fit the general dlang.org design (thanks to
>> Sebastian Wilzbach!).
>
> Shouldn't the dub command-line interface documentation be part of the
> "Documentation" menu pop-down? Right now we have to go to:
>
> Header -> Documentation -> Getting Started -> Scroll down past lots of
> text -> Command line interface

Yes, actually I had committed that change already, and just didn't 
rebuild the site yet :)

>
> Also, a minor improvement might be to:
>
> 1) have examples in the dub command line interface. E.g.  after the
> general usage fixed-width block, have something simple like a sequence
> of dub build, dub run, etc, for those that are just skimming the
> documentation and just want to get the general ideia. In the build
> section have a simple example followed by a more complex one which shows
> the more advanced use cases, and so on.
>
> 2) have more context of what some of the options are. People might read,
> say, the documentation of --build and see the option of ddox but have no
> idea what that is/means.

The information is currently procedurally generated from  the CLI --help 
(queried from the dub library), so most improvements should probably 
happen in that area. But adding some extra introduction/examples to the 
global section would of course fit well in the web page template, too.


More information about the Digitalmars-d-announce mailing list