Skip to content

Commit 2009dc7

Browse files
committed
Add instructions for how to add a site to Netlify for preview builds of documentation and storybooks
1 parent 7dc1db7 commit 2009dc7

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

docs/contributing/documentation/admins.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,3 +82,24 @@ To make it easier for other contributors to work with your project, update the f
8282
- Optionally set a branch to work on in `.gitmodules`.
8383

8484
Commit and push your changes to a remote, and submit a pull request against [`plone/[email protected]`](https://github.com/plone/documentation/compare).
85+
86+
87+
## Add a project to Netlify
88+
89+
```{todo}
90+
Some details need to be added to this section, including who to ping about the request with the repository name.
91+
```
92+
To add a new site to Netlify to preview built documentation or storybooks, you need to add a new site to Netlify.
93+
94+
1. Visit [Team Overview](https://app.netlify.com/teams/plone/overview).
95+
1. Click {guilabel}`Add a new site` and select {guilabel}`Import an existing project`.
96+
1. Click {guilabel}`Deploy with GitHub`.
97+
1. Select {guilabel}`plone` for the GitHub organization.
98+
1. Click {guilabel}`Configure Netlify on GitHub`.
99+
1. Select the organization to where you want to install Netlify.
100+
1. Click {guilabel}`Select repositories` and select the repository that you want to add.
101+
1. Click {guilabel}`Update access`.
102+
1. Netlify sends an email to members of the email group `admins` at `plone.org`, who need to review and approve the request.
103+
However the email doesn't specify the repository, and admins will not know what to do.
104+
You must send email to that group, including in your request the organization and repository, such as `plone/volto`.
105+
1. The admin must login to GitHub as an organization owner, then navigate to the requested repository's {guilabel}`Settings`.

0 commit comments

Comments
 (0)