docs: add semantic-release section

[drlkf]

I've managed to implement automatic semantic-release CI that uploads new
versions to Hackage automatically in my recently transferred
megaparsec-utils
package, I think it could be useful for other members to be able to do the same.

This new section documents how to make it work for your repository if you want
to use it as well.

EDIT: turns out I had forgotten to remove the HACKAGE_TOKEN secret, and since using the haskell_github_trust token, it does not have permissions to upload, even candidates. Is it conceivable to convert haskell_github_trust to an uploader on Hackage? Otherwise, people might have to configure their own personal token in the repositories, which is not ideal. Let me know what you think :)

[jamesdbrock]

Thanks @drlkf ! I have two things to say about this.

First, it is not possible to make the haskell_github_trust Hackage account an uploader account because this is against the Hackage policies.

Second, I would like to keep the main README terse and focused on explaining the basic organizational rules. I would prefer to have instructions about automatic release in a separate markdown file which is linked to from the main README file.

[drlkf]

it is not possible to make the haskell_github_trust Hackage account an uploader account because this is against the Hackage policies.

Ah I see, I'll contact the Hackage admin to see if they have a solution for organization accounts.

I would prefer to have instructions about automatic release in a separate markdown file which is linked to from the main README file.

Will do!