Documentation Improvement Initiative

[Panke]

On Monday, 17 February 2020 at 12:52:09 UTC, bachmeier wrote:
> Sorry for this not being more specific, but we need a version 
> of Rust's "The Cargo Book" for D:
> https://doc.rust-lang.org/cargo/
> The reason I can't be more specific is because I don't use Dub 
> except when doing so is trivial.
>
> We need documentation in particular on using Dub with mixed 
> language projects. The obvious case is C and D, but one of our 
> strengths is interoperability with basically all languages, so 
> we should have examples showing how to use Dub with projects 
> containing Fortran, Python, Lua, etc.

I'd second this. Figuring out how sub packages work, how to 
structure a project into different interdependent sub packages, 
how to fetch dependencies (dub upgrade does not work recursively 
:() took way too long coming back to D.

Generally a bit of best practice guidelines would be useful, see 
for example the my current question in the learn forum.