Improve headings and formatting

This commit is contained in:
theshka 2015-11-18 15:26:39 -06:00
parent ba766ea65c
commit 8093758b3e

View File

@ -82,10 +82,10 @@ Build & Release process
Defined below is a specification to which the Build and Release process of Pico should follow. We use [travis-ci](https://travis-ci.com) to automate the process, and each commit to `master` should be deployable. Once a `feature/branch` or the `master` branch have reached a point where the need for a version increase is necessary move through these phases to generate a Pico release. Defined below is a specification to which the Build and Release process of Pico should follow. We use [travis-ci](https://travis-ci.com) to automate the process, and each commit to `master` should be deployable. Once a `feature/branch` or the `master` branch have reached a point where the need for a version increase is necessary move through these phases to generate a Pico release.
#### Commit phase ### Commit phase
- Make/Commit/Merge changes - Make/Commit/Merge changes
- Use a formatted commit message - Use a formatted commit message with contents of changelog
Example: Example:
``` ```
@ -102,7 +102,7 @@ Defined below is a specification to which the Build and Release process of Pico
[SemVer](http://semver.org) increase to avoid the need for manual amendments.__ [SemVer](http://semver.org) increase to avoid the need for manual amendments.__
#### Analysis phase ### Analysis phase
Does the commit pass all `travis-ci` checks? Does the commit pass all `travis-ci` checks?
@ -110,31 +110,32 @@ Does the commit pass all `travis-ci` checks?
If not, all errors will need to be corrected before the build can complete. If not, all errors will need to be corrected before the build can complete.
#### Packaging phase ### Packaging phase
`travis-ci`
###### travis-ci
- will run [composer](http://getcomposer.org) locally. - will run [composer](http://getcomposer.org) locally.
- will create a ZIP archive (so vendor/ is included) - will create a ZIP archive (so vendor/ is included)
`manually` ###### manually
- build current documentation using [PhpDocumentor](http://phpdoc.org), - build current documentation using [PhpDocumentor](http://phpdoc.org),
#### Release phase ### Release phase
`travis-ci`
###### travis-ci
- will create new Git release at tag - will create new Git release at tag
- will include the properly formatted commit message including the changelog of items since the last release. - will include the properly formatted commit message including the changelog of items since the last release.
- will include ZIP archive in release - will include ZIP archive in release
`manually` ###### manually
- rename `docs/master` folder in `gh-pages` branch to the name of the previous Pico release. (e.g. `docs/pico-1.0.0`) - rename `docs/master` folder in `gh-pages` branch to the name of the previous Pico release. (e.g. `docs/pico-1.0.0`)
- upload current documentation to the `gh-pages` branch `/docs/master` - upload current documentation to the `gh-pages` branch `/docs/master`
- update release information on GitHub with: - update release information on GitHub with:
- Release title (taken from changelog) - Release title (taken from changelog)
- Changelog - Changelog
`automatically` ###### automatically
- Pico will be automatically updated on [Packagist](http://packagist.org/packages/picocms/pico) - Pico will be automatically updated on [Packagist](http://packagist.org/packages/picocms/pico)
#### Announcements ### Announcements
- Where to announce new Pico release? - Releases will be available at https://github.com/picocms/Pico/releases