Skip to content
This repository has been archived by the owner on Aug 4, 2020. It is now read-only.

Commit

Permalink
docs: readme changes and misc other changes
Browse files Browse the repository at this point in the history
  • Loading branch information
getaclue00 committed Dec 8, 2018
1 parent ad7fc22 commit e7eeb07
Show file tree
Hide file tree
Showing 4 changed files with 49 additions and 8 deletions.
46 changes: 45 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@ Template from https://gist.github.com/jxson/1784669

## Synopsis

[![Build Status](https://travis-ci.org/csprayca/superawesomebase.svg?branch=master)](https://travis-ci.org/csprayca/superawesomebase)
[![Coverage Status](https://coveralls.io/repos/github/csprayca/superawesomebase/badge.svg?branch=master)](https://coveralls.io/github/csprayca/superawesomebase?branch=master)
[![codecov](https://codecov.io/gh/csprayca/superawesomebase/branch/master/graph/badge.svg)](https://codecov.io/gh/csprayca/superawesomebase)
[![Greenkeeper badge](https://badges.greenkeeper.io/csprayca/superawesomebase.svg)](https://greenkeeper.io/)

At the top of the file there should be a short introduction and/ or overview that explains **what** the project is. This description should match descriptions added for package managers (Gemspec, package.json, etc.)
Expand All @@ -16,7 +19,48 @@ A short description of the motivation behind the creation and maintenance of the

## Installation

Provide code examples and explanations of how to get the project.
> Provide code examples and explanations of how to get the project.
<!-- START: TRY 1 -->

Here are some base required services that are super awesome for any project as a base. There are different pricing tier for a private projects vs. a public project.

Unit tests are required at the minimum. Why? Your future self will thank you.

### Travis CI

- the quick and dirty software system that just works
- use it to run our test suite
- and use it to perform other automated duties upon test suite completion

---

- requirements (_must_):
- setup env variables: `CODECOV_TOKEN` and `GH_TOKEN`
- `CODECOV_TOKEN` is found at `/settings` url of your project on codecov.io dashboard interface. For example, here is the link to mine: `https://codecov.io/gh/csprayca/superawesomebase/settings`
- `GH_TOKEN` is generated from github. You can search for the tutorials here on github. For example, here is the link to mine: `https://github.com/settings/tokens`
- I highly recommend that you are selective in what permissions you give to what key
- For example, my keys are per project. This way if one key is compromised only one project is affected. Minimize your security risk and general penetration space.

### Coveralls

- used for visual inspection of test coverage
- backup to codecov (if it is down or fails)
- reports generated after a successful test suite
- get your own badge. For example, mine is at `https://coveralls.io/github/csprayca/superawesomeredirector?branch=master`

### Codecov

- used for visual inspection of test coverage
- backup to coveralls (if it is down or fails)
- reports generated after a successful test suite
- get your own badge from `/settings/badge`. For example, mine is: `https://codecov.io/gh/csprayca/superawesomebase/settings/badge`

### Greenkeeper

- used to keep project dependencies up to date
- bot that is run whenever a npm dependency is updated
- view dashboard with an individual status per project. For example, mine is: `https://account.greenkeeper.io/account/csprayca`

## API Reference

Expand Down
2 changes: 1 addition & 1 deletion package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 1 addition & 3 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,7 @@
"lint:fix": "eslint --fix src",
"jsdoc": "jsdoc -c jsdoc.config.js",
"semantic-release": "semantic-release",
"commit": "git-cz",
"corp-release": "corp-semantic-release"
"commit": "git-cz"
},
"config": {
"commitizen": {
Expand Down Expand Up @@ -49,7 +48,6 @@
"babel-jest": "^23.6.0",
"codecov": "^3.1.0",
"commitizen": "^3.0.5",
"corp-semantic-release": "^6.4.0",
"coveralls": "^3.0.2",
"cz-conventional-changelog": "^2.1.0",
"eslint": "^5.9.0",
Expand Down
5 changes: 2 additions & 3 deletions release.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,8 @@ exports = module.exports = {
'@semantic-release/git',
{
assets: ['CHANGELOG.md', 'package.json', 'package-lock.json'],
message: `chore(release): ${nextRelease.version} [skip ci]\n\n${
nextRelease.notes
}`
message:
'chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}'
}
]
]
Expand Down

0 comments on commit e7eeb07

Please sign in to comment.