@Caleb, I've merged the first but got a question about the second: if I want to update the readme, what's the best way to proceed? switch to your release branch and do it there and then merge, or just merge and then add another commit on master?
I'm not too clear about what happens if I switch to your branch... I don't think I then have to push back to github? I can just sync master afterwards?
If the changes in question are really release related you could branch from my rel133 branch and continue adding commits where I left off. That could then be merged yourself or pushed to GH and open a PR back to mine for review. If they are not release items but just general devel work that be in before starting the release branch push them to your devel and rebase the release branch.
In the case of readme stuff I would treat it like a hotfix and do the changes straight to master, maybe even before you hit merge on the release branch.
@Benjol Depends on what the changes are I guess. If they have anything specific to 1.3.3 then after makes sense (or add to the release branch first). I was thinking there were readme things that just should have already been fixed unrelated to a new release to doing them as a hotfix from-to master made sense and having the 1.3.3 merge be the last thing in master made sense.
But it's really more about what makes sense for the changes you have in mind.
Nah, it's ok. From what you said, I can just switch to it locally, do my change and then merge to master and push that
@Caleb, is Oliver's quick insert ready for public consumption? I have a reference to his gist in the README which really needs updating or removing (to avoid even more confusion).
@Caleb, ok, done and merged to master (locally). What should I do with devel, merge master in, or rebase onto master (I would normally rebase, but I'm used to working alone)
@Benjol No don't rebase in this case, that will screw our feature branches up. Merge will also screw up the included files, so really the thing to do is cherry pick the readme fix back to devel.
That's an awkward one because release notes don't really belong in the repo anyway, they should be attached to tags or in a separate file that stays with the release branch only and doen't come back to devel.
@Benjol That is as it should be, but there is no reason they couldn't be branched much earlier and the release "set up", then periodically merge devel into the release branch until it's ready to go. That way release specific docs etc could be prepped any time.
@Benjol Correct.
> git checkout devel git cherry-pick <sha of your change>
And there are a standard set of changes it should always include sometime before merging to master. Version bump and adding prebuilt userscripts being the two obvious ones.
@Benjol The README should be worked on in devel and/or feature branches all along. (and NOT include release notes at all)
@Benjol Me too actually, and I've been wanting to understand some userscript stuff better to try my hand at another project so I've been picking up bits from you and @OliverSalzburg on that side of things.
@Benjol It's okay if they did, they will get upgraded too.
If they have the OLD 1.3.1 gist, they are pointed at the file it the root of the GH master still for updates and I updated that to be able to respond to them properly and get them on track too.
@Benjol No kidding. I'm not sure you saw my simulation branches trying to get the updater to handle the 4 separate cases it could have been stuck on but there are like 30 commits in my repo with -m debug before I figured out what to actually change and add to a clean branch. Testing it was a real bugbear when it behaved differently of different starting versions and URLs. I'm still crossing my fingers that it works.
@Benjol Ya, and they sometimes mention it in the moderator room when training new mods. I think there is a justafiable fear of encouraging users to go this way without thinking about their comments.
As I recall they did half-implement it for review queues at some point.
@Caleb, yeah, I guess so. Oh well... On another topic: I guess fighting with the update script has given you a clear idea of how you don't want to do auto-updating comment sets? :)
@Benjol If nothing else it is something to let brew in a feature branch somewhere for a good long time before pushing out to anyone! I have an idea it can be made to play nice but it isn't going to be a one-commit-and-were-done change.
The good news is that we should be able to use the auto-update code to let people install from a feature branch and still get updates and optionally eventually update them back to master if it their feature merges.
@Benjol Speaking of I just set that up in a parallel universe. Installing from this location should auto update to this branch as a longer term alternate master release and a corresponding devel branch is ready for hackery.
@Benjol No the min version isn't working right. It breaks the auto-updater so I have it pointed at the other one right now. We can migrate people if we get it working right. I wouldn't even mention it in the docs for the moment.
@Benjol Leaving ourselves cookie trails to be found and consumed by past or future iterations of ourselves was not something it takes into account by default and I didn't have time to figure out how to make it behave on top of the other updater chaos.
@Benjol I just converted the release notes to annotated tags. See here. Do you mind if I push those tags to your repo? I don't thing Github can do that with a PR.
Actually hang on I bet I can timestamp those properly first.
@Benjol Not sure. I think it added the tag the same as I did manually and then attached a bunch of meta information to it that isn't part of the repo itself.
Interestingly the meta information about the release survived be deleting and writting a new tag with the same name with the release note data in an annotation.
I took the liberty of creating a milestone (1.3.4) on GitHub. Just so we can keep track of issues to take care of before the next release cc @Benjol @Caleb