Group documentation about documentation HOT 4 CLOSED

what exactly do you mean? avoid the duplication?

from documentation.

Yeah. Both documents the same thing: how to use them in reusable packages and applications. They should probably be merged or grouped somehow I think.

from documentation.

agreed. duplication in documentation is just as bad as code duplication: confusing for the reader, and bound to go out of sync. my initial idea with the dedicated "virtual package" page was to make that something maintainers of libraries using httplug could link to for their users. but in the usage section, i felt we should explain how things work. i see two options:

a) eliminate the dedicated page. con: makes the information harder to link, and it might need to be a bit short when explaining in the context of installing httplug implementations.
b) only mention "virtual package" and link to the decicated page without further background information in the usage instructions. con: less linear to read through.

i tend towards option b, wdyt?

from documentation.

Fine with that. The tutorial should be clean enough to understand how to use, this part of the docs can be used then as a reference.

from documentation.