garris
Changelog and tags
Hello,
I wanted to catch up on what happened since our pull request for v2 and see what changed, I see there is no Changelog nor tags / release notes.
Did I miss something ?
Can I help in some way ?
@onigoetz thanks for checking in! I pushed version 2 to master and then NPM@latest weeks ago. Since then I've had to work out a few critical windows issues, try to catch up on PRs (which I am still very behind on) and also help some users who were a little confused by the upgrade. All and all tho, the response has been great! I am really grateful to see the upgrade.
You are right however-- I haven't gotten to updating GH release notes. I will do that this week.
There is also a performance bug I am concerned about -- #281. A few people have hit this issue. I made some suggestions in the issue but haven't had a chance to investigate further.
I also wanted to update the brochure with screens from my presentation at LinkedIn-- which went very well.
Hope that answers your questions-- let me know if you'd like more detail or have any specific requests.
Note: wife is out of town so I have kids and work to manage alone -- may be a little slow to respond.
Cheers!
@garris Great work on the project. Are there any plans to keep an updated changelog and tags for the project? I'd love to be able to see what new features have been added to each release!
Omg — panting — out of breath — so busy... you guys know I this for free right? halp! 🤪💜✨
FWIW — I usually do a LinkedIn article when we do something cool...
Eg. https://www.linkedin.com/pulse/backstopjs-version-30-chrome-headless-support-has-landed-shipon
https://www.linkedin.com/pulse/backstopjs-version-31-new-ui-usability-features-docker-garris-shipon
https://www.linkedin.com/pulse/backstopjs-v32-has-arrived-puppeteer-support-garris-shipon
These are also tweeted out etc.
Another request/vote for a changelog - I'm on v3 and would like to update to the lastest version but don't want to just jump in and hope for the best/wait to find errors. I'm guessing there are breaking changes because we're 2 major versions ahead but without a changelog have no idea how long it might take to upgrade (but equally have no reason to upgrade since I can't see anything new and v3 is working).
Totally agreed with @Patabugen ;) I want to bump to 5.0.x from 4.1.9 and I don't know what could happen.
I love Backstop JS and have been using the project for years. I do find that every time I check back in, I struggle to find what has changed with new versions.
Scrolling the commits isn't practical as there's a lot of noise. @garris, what's your current thoughts on this?
I'm also finding it quite difficult to see what has changed between versions. Upgrading from v5.0.8 to v5.35 seems to break a few tests that have been previously working fine. The tags/releases page isn't very informative and you need to look through individual commits - which can take a while.
A basic CHANGELOG would be quite helpful.
I am sorry about the confusion. I have not been able to keep up with the project the way I used to.
No worries @garris, appreciate how difficult maintaining an open source project can be. We all appreciate the work you have done and if this is something the wider community could help you do, I'm sure a few of us would be able to help.
Thank you @chrimesdev for the kind words!
I was thinking about this -- what the project really needs is release support. If someone would like to take on a release manager role or take part in some kind of release rotation I would gladly set permissions up to facilitate that. I think this would amount to maybe 2-4 hours a month if it is done well.
I am also open to other ideas/proposals.
Changelogs are also something which we could potentially do in retrospect - the difficulty is that it's usually eaiser for the developer to spot (breaking) changes than to identify them from commits.
@garris do you think you'd be able to roughly note down things as you're working on them and we can help expand/clarify/format them?
Thanks so much all. I just added a basic changelog and will keep this updated. Feel free to decorate or format it in any way. Cheers!