Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,8 @@
"editor/live-preview",
"editor/collaborate",
"editor/publish",
"editor/keyboard-shortcuts"
"editor/keyboard-shortcuts",
"editor/troubleshooting"
]
},
"installation",
Expand Down
24 changes: 24 additions & 0 deletions editor/troubleshooting.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
title: "Troubleshooting the web editor"
sidebarTitle: "Troubleshooting"
description: "Solutions for common web editor issues."
keywords: ["editor", "troubleshooting", "permissions", "write access", "github"]
---

## "You don't have write access to this repo"

<Frame>
<img src="/images/editor/write-access-error.png" alt="Error message showing user doesn't have write access to the repository." />
</Frame>

This error appears when your authorized GitHub account doesn't have write access to the documentation repository, even if you have full permissions in the Mintlify dashboard.

**Solutions:**

1. **Get repository write access**: Ask your GitHub admin to grant your GitHub account write (push) access to the documentation repository.

Check warning on line 18 in editor/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/troubleshooting.mdx#L18

Use parentheses judiciously.

2. **Unauthorize your GitHub account**: Remove your GitHub authorization in your [account settings](https://dashboard.mintlify.com/settings/account). The Mintlify GitHub App will sign commits on your behalf instead.

Check warning on line 20 in editor/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/troubleshooting.mdx#L20

Did you really mean 'Unauthorize'?

Check warning on line 20 in editor/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/troubleshooting.mdx#L20

Avoid using 'will'.

<Warning>
If you unauthorize your GitHub account, commits won't be attributed to your GitHub profile.

Check warning on line 23 in editor/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/troubleshooting.mdx#L23

Did you really mean 'unauthorize'?

Check warning on line 23 in editor/troubleshooting.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/troubleshooting.mdx#L23

In general, use active voice instead of passive voice ('be attributed').
</Warning>
Binary file added images/editor/write-access-error.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.