about summary refs log tree commit diff stats
diff options
context:
space:
mode:
authorBen Morrison <ben@gbmor.dev>2019-08-28 16:46:19 -0400
committerBen Morrison <ben@gbmor.dev>2019-08-28 16:46:19 -0400
commiteb33ceb75e6f7b385dac52821f14452c786099a2 (patch)
treef5f6cffcfdd91008ab9445c0ccf7bd7295af9e4e
parent910e69ac1b504ba0b9616d84280690c719cfaa3c (diff)
downloadgetwtxt-eb33ceb75e6f7b385dac52821f14452c786099a2.tar.gz
upgrading notes
-rw-r--r--README.md39
1 files changed, 33 insertions, 6 deletions
diff --git a/README.md b/README.md
index bf76528..e384407 100644
--- a/README.md
+++ b/README.md
@@ -9,13 +9,14 @@ Registries are designed to aggregate several users' statuses into a single locat
 facilitating the discovery of new users to follow and allowing the search of statuses
 for tags and key words.
 
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+&nbsp;
 \[ [Installation](#installation) \] 
-&nbsp; &nbsp; \[ [Configuration](#configuration) \] 
-&nbsp; &nbsp; \[ [Using the Registry](#using-the-registry) \] 
-&nbsp; &nbsp; \[ [Benchmarks](#benchmarks) \] 
-&nbsp; &nbsp; \[ [Other Documentation](#other-documentation) \] 
-&nbsp; &nbsp; \[ [Notes](#notes) \]
+&nbsp; \[ [Upgrading](#upgrading) \]
+&nbsp; \[ [Configuration](#configuration) \] 
+&nbsp; \[ [Using the Registry](#using-the-registry) \] 
+&nbsp; \[ [Benchmarks](#benchmarks) \] 
+&nbsp; \[ [Other Documentation](#other-documentation) \] 
+&nbsp; \[ [Notes](#notes) \]
 
 ## Features 
 &nbsp;[![GitHub release](https://img.shields.io/github/release/getwtxt/getwtxt.svg)](https://github.com/getwtxt/getwtxt/releases/latest)
@@ -88,6 +89,32 @@ $ make
 $ sudo make install
 ```
 
+## Upgrading
+
+Upgrading is a fairly simple process. First, we need to commit your local changes 
+to the configuration file.
+
+```
+$ cp /usr/local/getwtxt/getwtxt.yml .
+$ git add getwtxt.yml
+$ git commit -m 'my local config'
+```
+
+Now, we need to either run `make update` or `git pull --rebase`
+
+```
+$ make update
+...
+```
+
+Afterwards, follow the normal instructions for building and installing.
+If no configuration changes have been made since your last upgrade, 
+you will not need to commit them again. While `getwtxt` is pre-`1.0`, any
+patch-level updates (`v0.4.x`) will not change configuration values.
+
+Of course, you can also just back up your configuration file, then copy it
+back into `/usr/local/getwtxt/` after installing the new version.
+
 ## Configuration
 
 \[ [Proxying](#proxying) \] &nbsp; \[ [Starting getwtxt](#starting-getwtxt) \]