docs(sources):added content to github
---
-id: 4170125
title: GitHub Source
-description: TOCOME
+description: Add a GitHub Source to your Stencila project
+id: 4170125
+relatedArticles:
+ - ../hub/projects/manage-project-sources.md
+ authors:
+ - 'Colette Doughty <colette@stenci.la> (https://stenci.la)'
---
-//GITHUB SOURCE CONTENT TO COME
+You can add a GitHub repository as a source within your Stencila project.
+
+Before you start make sure your GitHub account is connected to your Stencila account. To check, go to your account **Settings** in the top right corner of your screen, scroll to the bottom of the page and under **Other** click **Account Connections**.
+
+## Creating a GitHub source
+
+To add a GitHub repository as a project source:
+
+1. Go to the project **Sources** page
+
+![](http://stencila.github.io/hub/manager/snaps/project-sources-menu-item.png)
+
+2. Press the **New** button and select **GitHub**
+
+![](http://stencila.github.io/hub/manager/snaps/project-sources-new-button.png)
+
+3. Enter the repository **name** and **subpath** directly or the **URL**
+
+![](http://stencila.github.io/hub/manager/snaps/project-sources-new-github-url.png)
+
+![](http://stencila.github.io/hub/manager/snaps/project-sources-new-github-repo.png)
+
+4. Add the **Path** that you want to link it to within the project (what you want to name your source) and **Create Source**
+
+![](http://stencila.github.io/hub/manager/snaps/project-sources-new-path-field.png)
+
+![](http://stencila.github.io/hub/manager/snaps/project-sources-new-create-button.png)
+
+## Pull your GitHub source
+
+Your Github repository is automatically "pulled" into your project and stores in your project's working directory.
+
+## Refresh your source
+
+You can **pull** the file/s again at any time to refresh the content.
