Skip to content

Create a Repository

Roy Clarkson edited this page Jan 7, 2015 · 7 revisions

Create a new private repository at https://github.com/spring-guides. Each GSG lives in its own repository at GitHub under the spring-guides organization. This step requires help from an owner on the spring-guides organization. Name the repo draft-gs-. Ultimately, the “draft” part of the title will be dropped when the new guide is ready to be published. The spring.io web site is designed to look for all gs-* repositories and publish those to the guides section. By initially naming the repository with a draft prefix, spring.io will ignore the repository.

Draft:

draft-gs-rest-service

Published:

gs-rest-service

Configure description

The description field in the repository is used on the spring.io web site to display the title and description for each guide. Edit the description to include the title and description separated by a double colon “::”. This is used by the spring.io web site to parse the two values. Enter the spring.io URL for the guide in the repository website field. Do not include “draft”.

Description format:

<title> :: <description>

URL:

http://spring.io/guides/gs/rest-service/

Note: do not use HTTPS URL

Add collaborators

Add committers, administrators, and viewers teams to the repository collaborators.

Add HipChat service hook

Configure the HipChat service hook with the following settings. This service hook will publish all repository activity to the Sagan Content HipChat room.

Additionally, check the Notify and Active checkboxes to ensure activity is published correctly.