Merge pull request #502 from outline/jori/readme-additions
README: Updated text and added a section on testing
This commit is contained in:
commit
588afbc8b4
23
README.md
23
README.md
|
@ -2,9 +2,9 @@
|
|||
<img src="https://user-images.githubusercontent.com/31465/34380645-bd67f474-eb0b-11e7-8d03-0151c1730654.png" height="29" />
|
||||
</p>
|
||||
<p align="center">
|
||||
<i>An open, extensible, knowledge base for your team built using React and Node.js.<br/>Try Outline out using our hosted version at <a href="https://www.getoutline.com">www.getoutline.com</a>.</i>
|
||||
<i>An open, extensible, knowledge base for your team built using React and Node.js.<br/>Try out Outline using our hosted version at <a href="https://www.getoutline.com">www.getoutline.com</a>.</i>
|
||||
<br/>
|
||||
<img src="https://user-images.githubusercontent.com/31465/34380057-6f760728-eb07-11e7-86ec-184e4cb1a902.jpg" alt="Outline" width="800" height="500">
|
||||
<img src="https://user-images.githubusercontent.com/31465/34456332-51e41eb0-ed9c-11e7-9fa9-20e7fa946494.jpg" alt="Outline" width="800" height="500">
|
||||
</p>
|
||||
<p align="center">
|
||||
<img src="https://circleci.com/gh/outline/outline.svg?style=shield&circle-token=c0c4c2f39990e277385d5c1ae96169c409eb887a" alt="" data-canonical-src="" style="max-width:100%;">
|
||||
|
@ -12,7 +12,7 @@
|
|||
<a href="https://github.com/prettier/prettier"><img src="https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat"></a>
|
||||
</p>
|
||||
|
||||
This is the source code that runs **Outline** and all the associated services. If you want to use outline then you don't need to run this code, we offer a hosted version of the app at [getoutline.com](https://www.getoutline.com).
|
||||
This is the source code that runs [**Outline**](https://www.getoutline.com) and all the associated services. If you want to use outline then you don't need to run this code, we offer a hosted version of the app at [getoutline.com](https://www.getoutline.com).
|
||||
|
||||
If you'd like to run your own copy of Outline or contribute to development then this is the place for you.
|
||||
|
||||
|
@ -84,6 +84,23 @@ Backend is driven by [Koa](http://koajs.com/) (API, web server), [Sequelize](htt
|
|||
- `server/presenters` - API responses for database models
|
||||
- `shared` - Code shared between frontend and backend applications
|
||||
|
||||
## Tests
|
||||
|
||||
We aim to have sufficient test coverage for critical parts of the application and aren't aiming for 100% unit test coverage. All API endpoints and anything authentication related should be thoroughly tested, and it's generally good to add tests for backend features and code.
|
||||
|
||||
To add new tests, write your tests with [Jest]https://facebook.github.io/jest/() add a file with `.test.js` extension next to the tested code.
|
||||
|
||||
```shell
|
||||
# To run all tests
|
||||
yarn test
|
||||
|
||||
# To run backend tests
|
||||
yarn test:server
|
||||
|
||||
# To run frontend tests
|
||||
yarn test:app
|
||||
```
|
||||
|
||||
## Contributing
|
||||
|
||||
Outline is still built and maintained by a small team – we'd love your help to fix bugs and add features!
|
||||
|
|
Reference in New Issue