diff --git a/modules/sysadmin_guide/nav.adoc b/modules/sysadmin_guide/nav.adoc index e4c3367..ab6b53e 100644 --- a/modules/sysadmin_guide/nav.adoc +++ b/modules/sysadmin_guide/nav.adoc @@ -41,7 +41,7 @@ ** xref:gdpr_sar.adoc[GDPR SAR - SOP] ** xref:geoip-city-wsgi.adoc[geoip-city-wsgi - SOP] ** xref:github2fedmsg.adoc[github2fedmsg - SOP] -** xref:github.adoc[github - SOP in review ] +** xref:github.adoc[Using github for Infra Projects - SOP] ** xref:greenwave.adoc[greenwave - SOP in review ] ** xref:guestdisk.adoc[guestdisk - SOP in review ] ** xref:guestedit.adoc[guestedit - SOP in review ] diff --git a/modules/sysadmin_guide/pages/github.adoc b/modules/sysadmin_guide/pages/github.adoc index 5c3fcd4..163bc7d 100644 --- a/modules/sysadmin_guide/pages/github.adoc +++ b/modules/sysadmin_guide/pages/github.adoc @@ -12,27 +12,29 @@ https://github.com/fedora-infra That will allow us to more easily track what projects we have. -[TODO] How do we create a new project and import it? +*TODO*: How do we create a new project and import it? + * After creating a new repo, click on the Settings tab to set up some fancy things. + If using git-flow for your project: -** Set the default branch from 'master' to 'develop'. Having the default -branch be develop is nice: new contributors will automatically start ++ +** Set the default branch from _master_ to _develop_. Having the default +branch be _develop_ is nice: new contributors will automatically start committing there if they're not paying attention to what branch they're on. You almost never want to commit directly to the master branch. + -If there does not exist a develop branch, you should create one by -branching off of master.: +If there does not exist a _develop_ branch, you should create one by +branching off of _master_: + .... $ git clone GIT_URL $ git checkout -b develop $ git push --all .... -** Set up an IRC hook for notifications. From the "settings" tab click -on "Webhooks & Services." Under the "Add Service" dropdown, find "IRC" +** Set up an IRC hook for notifications. From the `Settings` tab click +on `Webhooks & Services`. Under the `Add Service` dropdown, find `IRC` and click it. You might need to enter your password. In the form, you probably want the following values: *** Server, irc.freenode.net @@ -48,6 +50,7 @@ probably want the following values: *** Notice, *** Active, + == Add an EasyFix label The EasyFix label is used to mark bugs that are potentially fixable by @@ -62,6 +65,6 @@ curl -k -u '$GITHUB_USERNAME:$GITHUB_PASSWORD' https://api.github.com/repos/fedo Please try to use the same color for consistency between Fedora Infrastructure Projects. You can then add the github repo to the list -that easyfix.fedoraproject.org scans for easyfix tickets here: +that _easyfix.fedoraproject.org_ scans for easyfix tickets here: https://fedoraproject.org/wiki/Easyfix