Home

Faithlife C# Template Project

Follow these steps to create a new project/repo based on this template. It is assumed that the project name has one or more periods, e.g., Faithlife.Xyz, and the repo name does not, e.g., FaithlifeXyz. In the instructions below, replace these terms with your project's/repo's name as appropriate.

Clone the template

# clone the template repo
git clone git@github.com:Faithlife/CSharpTemplate.git FaithlifeXyz

# remove the template repository as the origin (a new origin will be added later)
cd FaithlifeXyz
git remote rm origin
git checkout -b master
git branch -D template

Modify the code

\\dev\util\FindReplaceCode\FindReplaceCode . ProjectName Faithlife.Xyz RepoName FaithlifeXyz
git add -A
git commit -m "Globally replace template placeholder strings."

Create a repository

1. Create a new repository at https://github.com/Faithlife.
2. Click the button to add collaborators; add Coders with Write permission.
3. Click Options; disable Wiki and Projects.

Set up CI builds

Travis CI

1. Go to https://travis-ci.org/.
2. Click + next to "My Repositories".
3. Click Faithlife on the left.
4. Click Sync account button in top right.
5. Find FaithlifeXyz in the list and enable it.

Appveyor

1. Go to https://ci.appveyor.com/projects.
2. Click New Project.
3. Find FaithlifeXyz in the list and click the Add button that appears on the far right on hover.

Push code

1. Go back to the GitHub repo page
2. Follow the instructions under "…or push an existing repository from the command line"

Change more GitHub settings

1. Go back to the repo settings page
2. Under Options, enable GitHub Pages for the "master branch /docs folder".
3. Under Branches, select master under Protected Branches and check Protect this branch.