From fc2c12c83793d9de406e202ea446ec34c90852f0 Mon Sep 17 00:00:00 2001
From: Morag S <5771389+morags@users.noreply.github.com>
Date: Sun, 27 Mar 2022 15:38:48 +0300
Subject: [PATCH 1/2] Add settings location
---
faq.md | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/faq.md b/faq.md
index 075ae61..b36691f 100644
--- a/faq.md
+++ b/faq.md
@@ -30,7 +30,10 @@ Most likely you are using VMWare which has a problem with hardware acceleration.
#### I can't initialize Git-Flow (Mac)
Probably you removed SourceTree recently and it broke your environment. https://github.com/fork-dev/Tracker/issues/418#issuecomment-425818588
+#### Where does Fork save user settings?
+Fork's settings are kept in three files: `settings.json`, `accounts.json`, and `custom-commands.json`. Under Windows, those are kept in `%localappdata%\Fork`.
+
#### I have a large repo and Fork shows only 50000 commits
You can configure the limit.
On Mac run `$ defaults write com.danpristupov.fork maxCommitCount 150000` in Terminal.
-On Windows edit the `MaxCommitCount` field in the `%localappdata%\fork\settings.json` file.
+On Windows edit the `MaxCommitCount` field in the `%localappdata%\Fork\settings.json` file.
From 799bea20eec04e8ea326c8fa8b53018836c087bb Mon Sep 17 00:00:00 2001
From: Morag S <5771389+morags@users.noreply.github.com>
Date: Sun, 27 Mar 2022 15:45:18 +0300
Subject: [PATCH 2/2] Categorize issues
---
faq.md | 50 ++++++++++++++++++++++++++++++++------------------
1 file changed, 32 insertions(+), 18 deletions(-)
diff --git a/faq.md b/faq.md
index b36691f..4ddf057 100644
--- a/faq.md
+++ b/faq.md
@@ -1,39 +1,53 @@
# Frequently Asked Questions (FAQ)
-#### How to compare two branches (or commits)?
-Just select them (hold Ctrl/Cmd for multiselection)
-
-#### I accidentally lost some commits
-Use reflog to see lost commits
+## General questions
#### Do you plan to support Linux
No, we don’t plan to support Linux until a decent UI library (comparable to WPF or Cocoa) appears on this platform.
-#### How can I commit and push?
-Hold Ctrl/Alt when commit
+#### Where does Fork save user settings?
+Fork's settings are kept in three files: `settings.json`, `accounts.json`, and `custom-commands.json`. Under Windows, those are kept in `%localappdata%\Fork`.
+
+## Troubleshooting
+
+### Files
#### Git doesn’t recognize my file as a text and Fork doesn’t show the diff
This may happen when a file is relatively small or in UTF-16 LE encoding. You can fix this by creating a rule (e.g. `*.sql text`) in `.gitattributes` file. (https://www.git-scm.com/docs/gitattributes)
+### Commits and branches
+
+#### How to compare two branches (or commits)?
+Just select them (hold Ctrl/Cmd for multiselection)
+
+#### How can I commit and push?
+Hold Ctrl/Alt when commit
+
#### How can I push multiple branches at once
Select them on the sidebar and call 'Push' from the context menu
+#### I have a large repo and Fork shows only 50000 commits
+You can configure the limit.
+On Mac run `$ defaults write com.danpristupov.fork maxCommitCount 150000` in Terminal.
+On Windows edit the `MaxCommitCount` field in the `%localappdata%\Fork\settings.json` file.
+
+#### I accidentally lost some commits
+Use reflog to see lost commits
+
+### Git-Flow
+
+#### I can't initialize Git-Flow (Mac)
+Probably you removed SourceTree recently and it broke your environment. https://github.com/fork-dev/Tracker/issues/418#issuecomment-425818588
+
+### GitHub & GitLab
+
#### Permission denied when accessing repos in my organization on GitHub
Ensure that Fork has access to your organization: https://github.com/settings/connections/applications/166b00df5e7ea4f78d4b
#### Receiving a "request requires higher privileges" error when trying to connect to GitLab with personal access token
Ensure the token provides access to the following scopes: `read_api`, and `user_api`
+### Other
+
#### The main window is blank (Windows)
Most likely you are using VMWare which has a problem with hardware acceleration. You can disable it in Fork config: https://github.com/ForkIssues/TrackerWin/issues/491#issuecomment-546605221
-
-#### I can't initialize Git-Flow (Mac)
-Probably you removed SourceTree recently and it broke your environment. https://github.com/fork-dev/Tracker/issues/418#issuecomment-425818588
-
-#### Where does Fork save user settings?
-Fork's settings are kept in three files: `settings.json`, `accounts.json`, and `custom-commands.json`. Under Windows, those are kept in `%localappdata%\Fork`.
-
-#### I have a large repo and Fork shows only 50000 commits
-You can configure the limit.
-On Mac run `$ defaults write com.danpristupov.fork maxCommitCount 150000` in Terminal.
-On Windows edit the `MaxCommitCount` field in the `%localappdata%\Fork\settings.json` file.