@jbudz now that I look at this one more time, I'm still not sure it's as clear as it could be. The first two steps (update the repo url, run apt-get update) are applicable to all versions of Kibana if you're switching major minor versions, is that correct?

The only difference between >=4.5.4 and <4.5.4 is that after updating the repo url (if necessary), the former will only need to run apt-get install kibana whereas the latter will need to remove/reinstall?

Yes, when switching minor versions and the major version 4. And then after updating the repo url, only when upgrading, it's easiest to remove/install instead of doing the permissions dance. My only comment on this might be to say something along the lines of 'when upgrading rpm or deb packages...` for the title to clarify that this doesn't cover the .tar.gzs, and does cover the deb and rpm files in addition to the repo.

@jbudz I tried to clarify things further, let me know what you think

Small comment above, otherwise LGTM.