Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add GitHub Release notes #4807

Closed
Blaisorblade opened this issue Oct 2, 2017 · 5 comments
Closed

Add GitHub Release notes #4807

Blaisorblade opened this issue Oct 2, 2017 · 5 comments
Assignees

Comments

@Blaisorblade
Copy link
Collaborator

I've been looking for Cabal 2 release notes in a few places. Turns out I can edit release notes for releases, so I took the liberty of adding links to @23Skidoo's post (http://coldwa.st/e/blog/2017-09-09-Cabal-2-0.html) to a couple of places:

https://github.com/haskell/cabal/releases/tag/Cabal-v2.0.0.2
https://github.com/haskell/cabal/releases/tag/cabal-install-v2.0.0.0

Unfortunately, I realized GitHub changed the release date and tagged me as releaser—I think that's unfortunate but hopefully not crucial. @23Skidoo was the original releaser—I imagine you might want to edit descriptions further.

I've already seen #4013, but a changelog belongs also on GitHub.

@Blaisorblade
Copy link
Collaborator Author

To clarify: I'm aware this move was haphazard, not coordinated, and I haven't contributed to cabal in ages.

I also think the new release notes are a strict improvement, they would have helped past me, and they're likely to help others.

@Blaisorblade
Copy link
Collaborator Author

Forgot to say: this was after I failed finding good such release notes for ~30 minutes.

Could links be added to

  1. https://github.com/haskell/cabal/releases, 2. http://hackage.haskell.org/package/cabal-install-2.0.0.0/changelog (or the package description), 3. http://hackage.haskell.org/package/Cabal-2.0.0.2/changelog (only semi-appropriate).

Some of that time was also spent on http://www.haskell.org/, https://wiki.haskell.org/Haskell, googling for "haskell cabal news 2" or such, looking at cabal-dev archives, and so on.

@23Skidoo
Copy link
Member

23Skidoo commented Oct 2, 2017

Unfortunately, I realized GitHub changed the release date and tagged me as releaser

np, I guess that updating the GitHub releases page should be added to release checklist.

I failed finding good such release notes for ~30 minutes

I just checked, and my blog post comes up as one of the top hits when you google for "cabal 2.0", however it may be just me. I'll add a couple more links.

@Blaisorblade
Copy link
Collaborator Author

Blaisorblade commented Oct 3, 2017

I just checked, and my blog post comes up as one of the top hits when you google for "cabal 2.0",

I had searched "cabal 2.0 news", which has pretty confusing results (including videogames?). Your blog is the 7th for me, which is probably why I missed it. I've seen issues on SEO for Haskell websites elsewhere, but I only understand "an expert could improve things and I'm not".

Here's a screenshot of my results. It also doubles as "where the list might be added".

image

EDIT:

updating the GitHub releases page should be added to release checklist.

👍

@portnov
Copy link

portnov commented Oct 13, 2017

Well, I managed to google this issue by "cabal 2.0 release notes" :)

23Skidoo added a commit that referenced this issue Oct 14, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants