improved docs

Author: ErikBjare

getting-started.rst

@@ -6,14 +6,12 @@ Getting started
     We're currently working on improving the installation experience by creating proper installers and packages,
     but for now we offer standalone archives containing everything you need.
 
-.. Content from aw-server/README.md should be moved here.
-
 Installation
 ============
 
 .. note::
-    The prebuilt executables have been known to sometimes have issues on Linux and macOS.
-    If they don't work for you consider `installing-from-source` and filing an issue.
+    The prebuilt packages are known to sometimes have issues on Linux.
+    If they don't work for you, please create an issue and consider `installing-from-source`.
 
 1. First, grab the `latest release from GitHub <https://github.com/ActivityWatch/activitywatch/releases>`_ for your operating system.
 

installing-from-source.rst

@@ -90,6 +90,8 @@ If anything doesn't work, let us know!
 Updating from source
 --------------------
 
-First pull the latest version of the repo with :code:`git pull` then get the updated submodules with :code:`git submodule update --recursive`. All that's needed then is a :code:`make build`.
+First pull the latest version of the repo with :code:`git pull` then get the updated submodules with :code:`git submodule update --init --recursive`. All that's needed then is a :code:`make build`.
 
-If it doesn't work, you can first try to run :code:`make uninstall` and then do a fresh :code:`make build`.
+If it doesn't work, you can first try to run :code:`make uninstall` and then do a fresh :code:`make build`. If that fails as well, remove the virtualenv and start over.
+
+Please report all issues you might have so we can make things easier for future users.