[Docs] Improve GitHub Setup Instructions

Author: Ben-G

README.md

@@ -2,4 +2,25 @@ Work-in-Progress Real World Example for Swift Flow.
 
 This project is currently driving some API changes, so it is using newer APIs than provided by the latest Swift Flow releases.
 
-Successful API changes will be merged into the Swift Flow projects.
+Successful API changes will be merged into the Swift Flow projects.
+
+# GitHub Configuration Instructions
+
+This demo requires you to create a GitHub API token that provides the app with access to content on GitHub.
+
+Create an OAuth application on GitHub and note the **Client ID** and the **Client Secret**; also make sure to set the **Authorization callback URL** to `swiftflowgithub://success` as shown here:
+
+![](RepoAssets/GitHub_OAuthSetup.png)
+
+Open `Credentials.swift` and enter the **Client ID** and the **Client Secret** of your OAuth application:
+
+```swift
+// In order to try out this demo you need to create an OAuth application on GitHub and provide
+// the credentials here.
+//
+// For more instructions take a look at the README.md in this git repository.
+//
+// Insert GitHub Token and Secret Here
+let gitHubClientId = ""
+let gitHubClientSecret = ""
+```

RepoAssets/GitHub_OAuthSetup.png

@@ -29,8 +29,8 @@ func authenticationReducer(state: AuthenticationState?, action: Action) -> Authe
 
 func initialAuthenticationState() -> AuthenticationState {
     let config = OAuthConfiguration(
-        token: gitHubToken,
-        secret: gitHubSecret,
+        token: gitHubClientId,
+        secret: gitHubClientSecret,
         scopes: ["repo", "read:org"]
     )