Skip to main content

Quickstart

Create beautiful, scalable documentation portals in minutes.

Getting Started​

Welcome to the WriteDocs documentation guide. Follow the instructions below to learn how to create, deploy, and take your documentation to the highest level with WriteDocs.

Requirements​

  • GitHub account
  • GitHub organization
  • Code editor, such as Visual Studio Code.

Step 1: Sign up to WriteDocs​

Create an account on WriteDocs using your email or GitHub account.

Step 2: Create your project​

Log in to WriteDocs and follow the steps to create your first project using your GitHub organization.

Changing your Repository's Name

WriteDocs don't recommend changing the repository name, but if you need to update it, contact our support at support@writedocs.io before updating it, so we can properly configure this update on our side.

Step 3: Access your documentation​

Online after 5 minutes

Your documentation will be available at the docs.writedocs.io domain, similar to the following example:

Repository nameDocumentation URL
myCompany-docsmyCompany.docs.writedocs.io
Locally using our CLI
  1. Run the following command line on your terminal to install our CLI:
npm i -g writedocs
  1. Start the WriteDocs development server:
writedocs dev
Custom Domain

If you are in the Startup or Growth plan, you can add a custom domain to your documentation. For additional information, open a thread at the #support channel in the WriteDocs Slack Community and our team will be happy to help you set up your custom domain.

Step 4: Customize your documentation (config.json)​

WriteDocs provides you with a config.json file in your documentation repository where you can quickly customize the appearance and structure of your documentation. You can find more information about setting up this file on the Global Settings page.

Step 5: Update your documentation​

When you push changes to the main branch, WriteDocs will automatically update and deploy your documentation. However, we really recommend you to use our CLI to preview your docs quickly on the local host when you make updates, and then commit them to GitHub.

Beginners Guide

If you don't have much experience in contributing to GitHub projects or using a doc-as-code approach, you can check our Beginners Guide that covers the basics of working with Git and using a code editor to create docs.

Commit status on GitHub

Whenever a new push is commited to your main branch, WriteDocs will keep you informed of the deployment status of your updates. You can keep track of this in your repository's main page.

Pending: Your new deployment is currently under way.

Failed/Error: Something went wrong. If you need assistance contact our support at support@writedocs.io by clicking the Details link at the right side.

Success: Your deploy is ready! Access it by clicking the Details link at the right side.