Added the first draft of CONTRIBUTING.md
parent
be485a6153
commit
89023a4a76
@ -0,0 +1,27 @@
|
||||
# Contributing to Matterwiki
|
||||
|
||||
Thank you for taking the time to contribute! :tada::+1:
|
||||
|
||||
## Basic guidelines for contributing
|
||||
* Start off by [forking this repository](https://github.com/Matterwiki/Matterwiki#fork-destination-box).
|
||||
* Create a branch to start your work `git checkout -b your-feature-name`
|
||||
* Commit your work
|
||||
* Create a pull request
|
||||
|
||||
## Local dev setup
|
||||
Once you've forked this repo and `clone`d your fork, you would have to run `npm install`. The development server can then be started with `npm run dev`.
|
||||
|
||||
## The code
|
||||
* The `api/` directory contains code for the node backend
|
||||
* The `client/` directory contains the React jsx files and basically all the frontend code powering this app
|
||||
* The `models/` directory has the bookshelf models associated with the SQLite DB
|
||||
* `node ./index.js` , starts the server, which serves the JS files, assets and of course, index.html.
|
||||
* For the production version, run `npm start build` and start `index.js` with a process manager like [PM2](http://pm2.keymetrics.io/).
|
||||
|
||||
## Features
|
||||
* The dev setup has webpack's Hot Module Replacement (HMR) enabled, which ([according to the docs](https://webpack.js.org/concepts/hot-module-replacement/)),
|
||||
|
||||
> exchanges, adds, or removes modules while an application is running without a page reload.
|
||||
|
||||
This helps improve speedup dev time significantly.
|
||||
* We've got sourcemaps enabled, so that makes debugging really easy.
|
Loading…
Reference in New Issue