Improve document & Add contributing file
This commit is contained in:
Qolzam
35
.eslintrc.json
Normal file
35
.eslintrc.json
Normal file
@@ -0,0 +1,35 @@
|
||||
{
|
||||
"env": {
|
||||
"browser": true,
|
||||
"es6": true
|
||||
},
|
||||
"extends": "eslint:recommended",
|
||||
"parserOptions": {
|
||||
"ecmaFeatures": {
|
||||
"experimentalObjectRestSpread": true,
|
||||
"jsx": true
|
||||
},
|
||||
"sourceType": "module"
|
||||
},
|
||||
"plugins": [
|
||||
"react"
|
||||
],
|
||||
"rules": {
|
||||
"indent": [
|
||||
"error",
|
||||
"tab"
|
||||
],
|
||||
"linebreak-style": [
|
||||
"error",
|
||||
"unix"
|
||||
],
|
||||
"quotes": [
|
||||
"error",
|
||||
"single"
|
||||
],
|
||||
"semi": [
|
||||
"error",
|
||||
"never"
|
||||
]
|
||||
}
|
||||
}
|
||||
83
.github/CONTRIBUTING.md
vendored
Normal file
83
.github/CONTRIBUTING.md
vendored
Normal file
@@ -0,0 +1,83 @@
|
||||
# Contributing
|
||||
|
||||
If you're reading this, you're awesome! Thank you for helping us make this project great and being a part of the React Socail Network community. Here are a few guidelines that will help you along the way.
|
||||
|
||||
## Asking Questions
|
||||
|
||||
For how-to questions and other non-issues, please use [Gitter](https://gitter.im/react-social-network/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) chat instead of Github issues.
|
||||
|
||||
## Opening an Issue
|
||||
|
||||
If you think you have found a bug, or have a new feature idea, please start by making sure it hasn't already been [reported or fixed](https://github.com/Qolzam/react-social-network/issues?utf8=%E2%9C%93&q=is:open+is:closed). You can search through existing issues and PRs to see if someone has reported one similar to yours.
|
||||
|
||||
Next, create a new issue that briefly explains the problem, and provides a bit of background as to the circumstances that triggered it, and steps to reproduce it.
|
||||
|
||||
For code issues please include:
|
||||
* React Social Network version
|
||||
* React version
|
||||
* Browser version
|
||||
* A code example or link to a repo, gist or running site.
|
||||
|
||||
For visual or layout problems, images or animated gifs can help explain your issue.
|
||||
It's even better with a live reproduction test case. Have a look at the [`ISSUE_TEMPLATE.md`](https://raw.githubusercontent.com/Qolzam/react-socail-network/master/.github/ISSUE_TEMPLATE.md) file for a live playground example.
|
||||
|
||||
### Issue Guidelines
|
||||
|
||||
Please Use a succint description. "doesn't work" doesn't help others find similar issues.
|
||||
|
||||
Please don't group multiple topics into one issue, but instead each should be its own issue.
|
||||
|
||||
And please don't just '+1' an issue. It spams the maintainers and doesn't help move the issue forward.
|
||||
|
||||
## Submitting a Pull Request
|
||||
|
||||
React Social Network is a community project, so pull requests are always welcome, but before working on a large change, it is best to open an issue first to discuss it with the maintainers.
|
||||
|
||||
When in doubt, keep your pull requests small. To give a PR the best chance of getting accepted, don't bundle more than one feature or bug fix per pull request. It's always best to create two smaller PRs than one big one.
|
||||
|
||||
As with issues, please begin the title with [LayerName].
|
||||
|
||||
When adding new features or modifying existing code, please attempt to include tests to confirm the new behaviour. You can read more about our test setup [here](https://qolzam.gitbooks.io/react-social-network/layers/tests.html).
|
||||
|
||||
### Branch Structure
|
||||
|
||||
All stable releases are tagged ([view tags](https://github.com/Qolzam/react-social-nework/tags)). At any given time, `master` represents the latest development version of the library.
|
||||
|
||||
#### `master` is unsafe
|
||||
|
||||
We will do our best to keep `master` in good shape, with tests passing at all times. But in order to move fast, we will make API changes that your application might not be compatible with.
|
||||
|
||||
## Getting started
|
||||
|
||||
Please create a new branch from an up to date master on your fork. (Note, urgent hotfixes should be branched off the latest stable release rather than master)
|
||||
|
||||
1. Fork the [react-social-network](https://github.com/Qolzam/react-social-network) repository on Github
|
||||
2. Clone your fork to your local machine `git clone --depth 1 git@github.com:<yourname>/react-social-network.git`
|
||||
3. Create a branch `git checkout -b my-topic-branch`
|
||||
4. Make your changes, lint, then push to github with `git push --set-upstream origin my-topic-branch`.
|
||||
5. Visit github and make your pull request.
|
||||
|
||||
If you have an existing local repository, please update it before you start, to minimise the chance of merge conflicts.
|
||||
```js
|
||||
git remote add upstream git@github.com:Qolzam/react-social-network.git
|
||||
git checkout master
|
||||
git pull upstream master
|
||||
git checkout -b my-topic-branch
|
||||
npm update
|
||||
```
|
||||
|
||||
### Testing the documentation site
|
||||
|
||||
The documentation site is built with [GitBook](https://www.gitbook.com/book/qolzam/react-social-network/details), so you just need to edit `*.md` files. You can easily edit whole documentation files form `docs` folder.
|
||||
|
||||
Test coverage is limited at present, but where possible, please add tests for any changes you make. Tests can be run with `npm test`.
|
||||
|
||||
### Coding style
|
||||
|
||||
Please follow the coding style of the current code base. React Social Network uses eslint, so if possible, enable linting in your editor to get realtime feedback.
|
||||
|
||||
Finally, when you submit a pull request, linting is run again by Continuous Integration testing, but hopefully by then your code is already clean!
|
||||
|
||||
## License
|
||||
|
||||
By contributing your code to the qolzam/react-social-network GitHub repository, you agree to license your contribution under the MIT license.
|
||||
11
.github/ISSUE_TEMPLATE.md
vendored
Normal file
11
.github/ISSUE_TEMPLATE.md
vendored
Normal file
@@ -0,0 +1,11 @@
|
||||
|
||||
### Steps
|
||||
|
||||
### Expected Result
|
||||
|
||||
### Actual Result
|
||||
|
||||
### Version
|
||||
x.y.z
|
||||
|
||||
### Testcase
|
||||
31
app/app.jsx
31
app/app.jsx
@@ -15,19 +15,14 @@ import { ConnectedRouter } from 'react-router-redux'
|
||||
import Master from 'Master'
|
||||
|
||||
// - Impport actions
|
||||
import * as authorizeActions from 'authorizeActions'
|
||||
import * as globalActions from 'globalActions'
|
||||
import * as userActions from 'userActions'
|
||||
|
||||
// Set default data
|
||||
store.subscribe(() => {
|
||||
var state = store.getState();
|
||||
|
||||
});
|
||||
})
|
||||
|
||||
// Needed for onTouchTap
|
||||
// http://stackoverflow.com/a/34015469/988941
|
||||
injectTapEventPlugin();
|
||||
injectTapEventPlugin()
|
||||
|
||||
// This replaces the textColor value on the palette
|
||||
// and then update the keys for each component that depends on it.
|
||||
@@ -35,22 +30,22 @@ injectTapEventPlugin();
|
||||
const muiTheme = getMuiTheme({
|
||||
|
||||
|
||||
});
|
||||
})
|
||||
|
||||
|
||||
|
||||
// App css
|
||||
require('applicationStyles');
|
||||
require('applicationStyles')
|
||||
const supportsHistory = 'pushState' in window.history
|
||||
|
||||
ReactDOM.render(
|
||||
<Provider store={store}>
|
||||
<ConnectedRouter history={history}>
|
||||
<MuiThemeProvider muiTheme={getMuiTheme(lightBaseTheme)}>
|
||||
<Master />
|
||||
</MuiThemeProvider>
|
||||
<Provider store={store}>
|
||||
<ConnectedRouter history={history}>
|
||||
<MuiThemeProvider muiTheme={getMuiTheme(lightBaseTheme)}>
|
||||
<Master />
|
||||
</MuiThemeProvider>
|
||||
|
||||
</ConnectedRouter>
|
||||
</Provider>,
|
||||
document.getElementById('app')
|
||||
);
|
||||
</ConnectedRouter>
|
||||
</Provider>,
|
||||
document.getElementById('app')
|
||||
)
|
||||
|
||||
Reference in New Issue
Block a user