Fixed sample.env, added more comments for clarification

Author: EstoesMoises

app-config.yaml

@@ -8,9 +8,15 @@ organization:
 stackoverflow:
   baseUrl: ${STACK_OVERFLOW_INSTANCE_URL}
   # teamName: ${STACK_OVERFLOW_TEAM_NAME}
+
   apiAccessToken: ${STACK_OVERFLOW_API_ACCESS_TOKEN}
+  # The API Access Token is used for the Questions' collator, a no-expiry, read-only token is recommended.
+
   clientId: ${STACK_OVERFLOW_CLIENT_ID}
+  # The clientid must be for an API Application with read-write access.
+
   redirectUri: ${STACK_OVERFLOW_REDIRECT_URI}
+  # This should redirect to your Stack Overfow for Teams route on Backstage. E.g. https://<backstage-domain>/stack-overflow-teams
 
 backend:
   # Used for enabling authentication, secret is shared by all backend plugins

packages/backend/sample.env

@@ -1,5 +1,7 @@
 STACK_OVERFLOW_INSTANCE_URL=https://[your-site]/api/v3
-# This token doesn't needd scope=write_access, this is only use to create an index of all the questions of your Stack Overflow instance
-STACK_OVERFLOW_ENTERPRISE_ACCESS_TOKEN=
-# API Application must have read-write permissions, please provide the application's id
-STACK_OVERFLOW_CLIENT_ID=
+# This token doesn't needd scope=write_access, this is only use to create an index of all the questions of your Stack Overflow instance.
+STACK_OVERFLOW_API_ACCESS_TOKEN=
+# API Application must have read-write permissions, please provide the application's id.
+STACK_OVERFLOW_CLIENT_ID=
+# To run the integration on localhost, we need to redirect to localhost. SOE Requires a top-level domain, therefore we are using a redirection service that takes you to localhost. If you do have Backstage on a top level domain, change the redirect uri accordingly.
+STACK_OVERFLOW_REDIRECT_URI=http://redirectmeto.com/http://localhost:3000/stack-overflow-teams