Frequently Asked Questions

Quick answers to commonly asked questions about ArchDoc.

Account & Access

How do I reset my password?

1. Go to the login page
2. Click "Forgot Password"
3. Enter your email address
4. Check your email for reset link
5. Click the link and set a new password

I didn't receive my verification email

Check:

• Spam/junk folder
• Correct email address was used
• Wait a few minutes

If still not received:

• Try registering again
• Contact support

How do I delete my account?

1. Go to Dashboard > Settings
2. Scroll to the Danger Zone section
3. Click Delete Account
4. Confirm the deletion

Your account is soft-deleted and you'll be signed out immediately. Your documents remain in the organization. If you log back in, your account will be reactivated (but placed on the Free plan regardless of your previous subscription).

How do I delete my organization?

Admins can deactivate an entire organization:

1. Go to Dashboard > Settings
2. Scroll to the Danger Zone section
3. Click Delete Organization
4. Confirm the deactivation

Documents and data are preserved. The organization can be reactivated by any user logging back in. If the subscription is no longer valid at reactivation, the organization is moved to the Free plan.

Plans & Billing

What's included in the Free plan?

• 2 user seats
• 5 documents
• Basic editing features
• Excalidraw diagrams

How do I upgrade my plan?

1. Go to Dashboard > Billing
2. Click Upgrade Plan
3. Select your new plan (Base or Premium)
4. Complete payment via Stripe

Can I downgrade my plan?

Yes, but with limitations:

• Seat count must fit new plan limits
• Document count must fit new plan limits
• Remove excess members/documents before downgrading

When am I billed?

• Monthly billing on your signup date
• Upgrade charges are prorated
• Downgrades apply at next billing cycle

What payment methods are accepted?

We use Stripe and accept:

• Credit cards (Visa, Mastercard, Amex)
• Debit cards
• Some regional payment methods

How do I cancel my subscription?

1. Go to Dashboard > Billing
2. Manage your subscription through the Stripe billing portal
3. You'll retain access until the period ends

Documents

How many documents can I create?

What's the difference between ADR, RFC, and Design Doc?

• ADR: Architecture Decision Records - Short, focused decisions
• RFC: Request for Comments - Proposals for discussion
• Design Doc: Detailed technical designs

Can I convert a document type?

Currently, document types cannot be changed after creation. Create a new document and copy content if needed.

How do I delete a document?

1. Open the document
2. Click the menu (⋮) or settings
3. Select Delete
4. Confirm deletion

Can I restore a deleted document?

No, deletion is permanent. We recommend exporting important documents before deleting.

Editor

Why isn't my content saving?

ArchDoc auto-saves, but check:

• Internet connection
• You haven't been logged out
• Browser hasn't crashed

If issues persist, copy your content and refresh.

Can multiple people edit at once?

Yes! Real-time collaboration is supported:

• See other users' cursors
• Changes sync instantly
• No conflicts or overwriting

How do I add code blocks?

1. Type ``` (three backticks)
2. Optionally add language (e.g., ```python)
3. Press Enter
4. Write your code
5. Press Enter after the code to exit

Why don't images appear?

Check:

• Image URL is accessible
• Image hasn't been deleted from source
• URL is correct (https://)

How do I export my document?

1. Open the document
2. Click Export or the export icon
3. Choose format (Markdown, PDF)
4. Download the file

Diagrams

How do I add an Excalidraw diagram?

1. In the editor, use the command menu
2. Select "Excalidraw" or diagram option
3. Draw in the canvas that appears
4. Your diagram is saved with the document

Can I import Excalidraw files?

The current integration creates diagrams within ArchDoc. For complex imports, you may need to recreate or copy elements.

How do I create a Mermaid diagram?

1. Create a code block with mermaid as the language
2. Write your Mermaid syntax
3. The diagram renders automatically

Example:

```mermaid
graph LR
    A --> B --> C
```

Sign-offs

What is a sign-off?

A sign-off is formal approval of a document. Required signers review and approve before the document is considered accepted.

Who can request sign-offs?

The document author or any team member with edit access can add signers.

Can I change my sign-off?

Yes, you can change an "Approved" to "Changes Requested" or vice versa by signing off again.

What happens when everyone signs off?

The document status can be changed to "ACCEPTED", indicating formal approval.

Team & Organization

How do I invite someone to my team?

1. Go to Dashboard > Settings
2. Find the Team Members section
3. Click Invite Member
4. Enter their email and assign a role
5. They'll receive an invitation email

What's the difference between Admin and Member?

Can I be in multiple organizations?

Yes, one account can be invited to multiple organizations. Switch between them in the dashboard.

How do I leave an organization?

Contact your organization's Admin to be removed.

GitHub Integration

Which plans include GitHub integration?

Why can't I see my organization's repos?

• Ensure OAuth is approved by your GitHub org
• Check you have write access to repos
• Ask org admin to approve the OAuth app

Does syncing update GitHub automatically?

No, you manually sync when ready. This gives you control over what's pushed.

Can I edit synced docs in GitHub?

You can, but changes won't sync back to ArchDoc. We recommend ArchDoc as the source of truth.

Technical

Which browsers are supported?

• Chrome (recommended)
• Firefox
• Safari
• Edge

Is my data encrypted?

Yes:

• Data encrypted in transit (HTTPS)
• Data encrypted at rest
• Secure authentication

Where is my data stored?

Data is stored on secure cloud infrastructure with regular backups.

Can I self-host ArchDoc?

Currently, ArchDoc is only available as a hosted service. Contact us for enterprise options.

Still Have Questions?

If your question isn't answered here:

1. Create a support ticket
2. Our team will assist you