[Recipes doc] Need for documentation

[symfony]

[Recipes doc] Need for documentation

[stof]

Well, many packages just use the readme for the doc. But we should encourage them to provide the link to the doc if they have it elsewhere

[stof]

Having the documentation link in the config file looks wrong to me: most bundles don't need a config file in the recipe as their default config is fine.

I'm not sure about having a doc link in the recipe. People using flex will never see the recipe file. They will just do composer require acme/awesome-bundle and the recipe file will be used internally by the flex plugin.

So the best place to jave the doc link is still in the Packagist metadata IMO

[Pierstoval]

So we could require the package to have a support.docs entry in the composer.json file, even though it's not largely used atm?
This way, Flex can show the documentation link on each package installation

[chalasr]

I think the post-install.txt is good enough for giving some hints like a link to a particular documentation.

[stof]

And I don't think flex should output the link to the doc of all installed packages. It would be spammy. composer show acme/awesome-bundle will already display it.

[Pierstoval]

Well then I consider it's case closed, if composer & post-install already give the necessary tools for it