diff --git a/agora-install.md b/agora-install.md
index ff79856bc..e65ec6707 100644
--- a/agora-install.md
+++ b/agora-install.md
@@ -3,11 +3,11 @@
 - Set up a [[personal knowledge management]] system for note taking and upload your notes in [[Markdown]] format to a git repository of your choice.
   - Get a [[github]] account if you don't have a git host already: <https://github.com>.
     - Install [[git]] if needed: <https://git-scm.com/download>.
-  - If you don't have a personal knowledge management system of choice, we recommend [[foam]]: <https://foambubble.github.io/foam/>.
-    - To use foam, fork its template repository: <https://github.com/foambubble/foam-template/>. You can use any name you desire for your repository.
-    - Install and launch [[vscode]]: <https://code.visualstudio.com/download>.
+  - If you don't have a personal knowledge management system of choice, we recommend [[foam]]: <https://foambubble.github.io/foam/>. To use foam: 
+    - Fork its template repository: <https://github.com/foambubble/foam-template/>. You can use any name you desire for your repository.
+    - Install [[vscode]] if necessary: <https://code.visualstudio.com/download>. Launch it.
     - Select 'clone repository' -- if you're using [[github]], log in with [[github]]. Authorize [[vscode]] to make changes to your account. It sometimes requires you to retry once for some reason.
-    - [[vscode]] should offer to install recommended extensions. Say yes.
+      - [[vscode]] should offer to install recommended extensions. Say yes.
     - You can now use [[foam]]:
       - Press alt-d to start a new daily note (your journal). 
       - Write [[wikilinks]] to link to other pages. 
@@ -15,6 +15,9 @@
       - ctrl-p to open an existing note.
       - ctrl-shift-p to bring up the [[vscode]] command palete; you can search for any command and see keyboard shortcuts.
       - Whenever you want to commit to your repository (and the Agora), save all files and use the "branch-like" icon on the left toolbar to review changes and write a commit message.
+      - You may need to set a user.name and user.email in git. To do this, open the terminal and type:
+        - git config --global user.name "Your Name"
+        - git config --global user.email "yourname@example.com"
 - Send email to signup@anagora.org or a Twitter DM to [[flancian]] with:
   - The URL of your repo.
   - Your desired username (can be distinct from that of your git host).