Set up your first help centre

Set up your first project, connect the repositories that make up your product, and let Ellie draft your help centre. By the end, you can review drafts or publish them to your public help centre.

Step by step

1. Open Projects from the sidebar.
2. Click Get started if you have no projects yet, or New project if you already have one.
   
3. In Connect, click Connect GitHub.
4. Install the Ellie Docs GitHub App.
5. Select the repositories that make up your product.
6. If you are connecting one repository, click Select on that repo.
7. If you are connecting multiple repositories, tick the repos you want and click Analyse {n} repos as one product.
   
8. In Your docs, choose whether you are Starting fresh or We have existing help articles.
9. If you already have help articles, enter your Help centre URL and leave import selected if you want imported articles to arrive as drafts.
10. Choose where your support docs live today, such as Intercom or Zendesk.
11. Enter your marketing website if you want Ellie to read it.
12. Click Continue, or click Skip for now to move on without adding these details.
13. In Understand, review what Ellie found about your product.
14. Click That's right → if the summary is correct.
15. If you need to change it, click Edit details, update What is your product? and Tone notes (optional), then click Save and continue →.
16. In App access, choose how Ellie should take screenshots.
17. To use Ellie’s hosted test environment, choose Run a sandbox copy for me (recommended).
18. To use your live app, choose Use my live app and enter App URL plus an email and password.
19. To continue without screenshots, choose Skip screenshots for now.
20. Click Continue.
21. In Write docs, let Ellie finish drafting your help centre.
22. On Your docs are drafted, click Review drafts first to open the project, or click Publish all & view your help centre to publish immediately.
    

Good to know

What if I close onboarding before it finishes? Onboarding resumes where you left off. The current step is kept in the URL, so you can reopen it and continue.

What if Ellie cannot read my repository? In Understand, you can use Retry. If Ellie reports that it couldn’t access the repository, check that the Ellie Docs GitHub App has access to it.

What if writing finishes with no drafts? Use Go to project and re-run writing from the project. If it keeps happening, reply to any Ellie Docs email.

Why can’t I create another project? Projects are limited by plan: Free 1, Starter 1, Growth 3, Scale 10. If you hit the limit, creation fails with: The <Plan> plan includes N project(s) — upgrade to add more.