How to Update Slate 2.7.0 to Latest Version

[aaykut]

OK y'all, I am by no means a programmer, I just use Slate as a tool to develop documentation -- I have a working 2.7.0 environment on my Mac which I have installed natively. How do I update to the latest 2.12.0 version without breaking anything? Thanks.

[aaykut]

After tearing out my hair for a day and a half, I backed up my data, deleted the slate directory and did a clean install from this site; restored my data, did a bundle install and everything is working again 😄 may not be the best way to go but hey it works 🤷 .

[MasterOdin]

All version updates usually update the Gemfile and Gemfile.lock files. The other files affected for given version range are:

• source/javascripts/lib/_lunr.js was updated in 2.8.0
• source/javascript/app/_copy.js in 616df62 in 2.8.0
• source/javascript/app/_lang.js in 681f481 in 2.9.1
• source/javascripts/lib/_jquery.js was updated in 2.11.0
• source/layouts/layout.erb in ef09832 in 2.11.0

The easiest way to update usually though is to have your slate repo, and then mark this one as an upstream (https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/configuring-a-remote-for-a-fork), and then fetching the tags for the upstream (git fetch --tags upstream) and then doing a merge of a given release onto your main branch (git merge <tag_name, e.g. git merge v2.12.0), and then resolving any merge conflicts, which may be only a few or may be many depending on how different your code is. Merge conflicts on the index.md.html file can usually be thrown away at least, while the others you'd have to work through yourself depending on what your customizations were.