From eb940a12631ed1061678d6db47cd116a837a83b8 Mon Sep 17 00:00:00 2001
From: BekahHW <34313413+BekahHW@users.noreply.github.com>
Date: Wed, 15 Nov 2023 12:19:46 -0500
Subject: [PATCH] docs: Add Team Sync instructions to FAQs (#207)

---
 docs/community/faqs.md | 13 ++++++++++++-
 docs/features/lists.md |  4 +++-
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/docs/community/faqs.md b/docs/community/faqs.md
index 57626a69..22d5a66d 100644
--- a/docs/community/faqs.md
+++ b/docs/community/faqs.md
@@ -20,4 +20,15 @@ We believe that [good first issues don't exist](https://opensauced.pizza/blog/go
 Create an [insight page](https://app.opensauced.pizza/hub/insights) or add your merged pull request to [a highlight](https://app.opensauced.pizza/feed).
 
 3. **I want to provide feedback on OpenSauced.**
-We love feedback. Post your suggestion in our [feedback repository](https://github.com/orgs/open-sauced/discussions). 
+We love feedback. Post your suggestion in our [feedback repository](https://github.com/orgs/open-sauced/discussions).
+
+## [Sync your GitHub Team](#sync-your-github-team)
+1. **I don't see my Organization on Sync your GitHub Team?**
+You may not see your Organization if you are not a "public" member. You can update this by going to the organization on GitHub and selecting the People tab. Next, search for your name. You can then change "private" to "public." For full instructions, see [this guide](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership).
+
+2. **I get an error when I try to select my team in Sync your GitHub Team**
+If you see your Organization, but you get an error when you try to select a team, your organization likely has third-party applications restricted. You can check this by going to your organization on GitHub, selecting Settings, and then Third-party access. 
+
+  If you're an **owner** of the repository, you can select "Allow select third-party access" or specifically approve OpenSauced by following the directions in [this guide](https://docs.github.com/en/organizations/managing-oauth-access-to-your-organizations-data/approving-oauth-apps-for-your-organization).
+
+  If you are not an owner of the organization, you will need to request access from your organization's owner. For full instructions, see [this guide](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps). 
\ No newline at end of file
diff --git a/docs/features/lists.md b/docs/features/lists.md
index 764c8f2f..98d92984 100644
--- a/docs/features/lists.md
+++ b/docs/features/lists.md
@@ -19,4 +19,6 @@ There are two ways to add a list:
 2. Import your GitHub following:
 Connect to your GitHub to create a list with all the Contributors you follow.
 
-Once your list is created, you'll be able to see an overview of all the contributors in your list, a graph of their activity, and a detailed breakdown of the contributors.
\ No newline at end of file
+Once your list is created, you'll be able to see an overview of all the contributors in your list, a graph of their activity, and a detailed breakdown of the contributors.
+
+If you're having trouble syncing your Organization or Team, check out our [Sync Your GitHub Team in our FAQs](https://docs.opensauced.pizza/community/faqs/#sync-your-github-team).
\ No newline at end of file