Troubleshooting FAQ

Note: If you have problems getting the tools installed on your laptop, you can always edit your files directly on GitHub. Navigate to the file you want to edit (probably guidebook.md) and click the pencil edit icon. From there, you can edit the Markdown directly.

Getting Git configured locally

If you have problems with Git access or error messages from VS Code about missing Git, verify that you have it installed. Open a command window / Terminal window and type:

git --version

If it is not installed, download and install the Git executable:

Git Download page

This will require admin access. Open your Self Service application and select the option "Grant Temporary Admin Rights 2 Hours". If you don't have this, request access from Surf.

Two Factor Authentication and Git

If you have two factor authentication turned on in your GitHub account, you will need to use "Personal Access Tokens" in order to connect via the command line and/or VS Code. In order to do this, follow the steps in this guide