dlang / dub-docs

Documentation for the Dub package manager
https://dub.pm
Boost Software License 1.0
16 stars 23 forks source link

Where is the package format documentation? #89

Open CyberShadow opened 6 months ago

CyberShadow commented 6 months ago

I remember seeing documentation (for JSON and SDL) describing the dub.json / dub.sdl files.

However, I can no longer find it on dub.pm. Instead, there are now many pages that talk about a lot of things in general terms but seem to be missing descriptions of the file format.

For example, the configurations page at https://dub.pm/dub-reference/configurations/ doesn't actually describe how to define a configuration.

CyberShadow commented 6 months ago

Ah, I found it! They are at

https://dub.pm/dub-reference/package_settings/#configurations

I think there should be a very clear link to that destination from the page describing the configurations.

I have more issues with that:

CyberShadow commented 6 months ago

Could the navigation on the left be split up into categories, so that it's clear which links go to pages that describe syntax, and which go to pages that describe the concepts in general terms?