Cleaning README.

This commit is contained in:
Gunther Brunner
2015-06-18 19:18:42 +09:00
parent b91fd1ee2c
commit 3ff066d672
6 changed files with 103 additions and 63 deletions

26
CONTRIBUTING.md Normal file
View File

@@ -0,0 +1,26 @@
# Contributing
We are happy to accept any contributions that make sense and respect the rules listed below.
## How to contribute
1. Fork the repo.
2. Create a feature branch for your contribution out of the `master` branch. Only one contribution per branch is accepted.
3. Implement your contribution while respecting our rules (see below).
4. If possible, add tests for your contribution to make sure it actually works.
5. Submit a pull request against our `master` branch!
## Rules
* **Do** use feature branches.
* **Do** conform to existing coding style so that your contribution fits in.
* **Do** use [EditorConfig] to enforce our [whitespace rules](.editorconfig). If your editor is not supported, enforce the settings manually.
* **Do not** touch the `version` field in [package.json](package.json).
* **Do not** commit any generated files, unless already in the repo. If absolutely necessary, explain why.
* **Do not** create any top level files or directories. If absolutely necessary, explain why and update [.npmignore](.npmignore).
## License
By contributing your code, you agree to license your contribution under our [LICENSE](LICENSE).
[editorconfig]: <http://editorconfig.org/>

17
GETTING_STARTED.md Normal file
View File

@@ -0,0 +1,17 @@
Getting started
===
- `brew install rethinkdb`
- Make internal npm work
- `brew install protobuf`
- `brew install zmq`
- `npm install -g bower`
- `npm install`
- `bower install`
- `npm link`
Run
===
- `rethinkdb`
- `stf local`

17
LICENSE Normal file
View File

@@ -0,0 +1,17 @@
Copyright © CyberAgent, Inc. All Rights Reserved.
Licensed under the GNU AGPL, Version 3.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.gnu.org/licenses/agpl-3.0.html
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
If AGPL 3.0 is not suitable for your use case,
commercial licenses are also available from CyberAgent, Inc.,
including free licenses. Contact us at stf@cyberegant.co.jp

View File

@@ -1,10 +1,10 @@
# STF
===
STF (Smartphone Test Farm) is a service for remotely debugging real smartphone devices from the comfort of your browser.
STF (Smartphone Test Farm) is a full featured SaaS for remotely debugging real smartphone devices from the comfort of your browser.
Features
===
- Support Android devices from 2.3 to 5.0
- Support Android devices from 2.3 to 5.0, including Android M
- Fast device screen transfer
- Remote mouse and keyboard input
- Multitouch support
@@ -23,88 +23,37 @@ Features
- Reverse port forwarding for development
- Device hardware specific information
Getting started
===
- `brew install rethinkdb`
- Make internal npm work
- `brew install protobuf`
- `brew install zmq`
- `npm install -g bower`
- `npm install`
- `bower install`
- `npm link`
Requirements
===
- NodeJS
- Bower
- RethinkDB
Run
Getting Started
===
- `rethinkdb`
- `stf local`
See [GETTING_STARTED.md](GETTING_STARTED.md).
Update
Updating
===
- `git pull`
- `npm install`
- `bower install`
See [UPDATING.md](UPDATING.md).
### Tests
## Unit Frontend
- `brew install phantomjs`
- `gulp karma`
## E2E Frontend
### On first run
- `gulp webdriver-update`
### Chrome Local STF
- Connect a device
- Run stf
- `gulp protractor`
### Multiple Browsers Local STF with a specific suite
- Connect a device
- Run stf
- `gulp protractor --multi --suite devices`
### Chrome Remote STF
- `export STF_URL='http://stf-url/#!/'`
- `export STF_USERNAME='user'`
- `export STF_PASSWORD='pass'`
- `gulp protractor`
Testing
===
See [TESTING.md](TESTING.md).
Contributing
===
See [CONTRIBUTING.md](CONTRIBUTING.md).
License
===
## Main repository
- Free Software Foundations [GNU AGPL v3.0](http://www.fsf.org/licensing/licenses/agpl-3.0.html).
- Commercial licenses are also available from [CyberAgent, Inc.](mailto:stf@cyberagent.co.jp), including free licenses.
## Small repositories
- [Apache License v2.0.](http://www.apache.org/licenses/LICENSE-2.0)
## Documentation
- Documentation: [Creative Commons](http://creativecommons.org/licenses/by-nc-sa/3.0/).
See [LICENSE](LICENSE).
Copyright © CyberAgent, Inc. All Rights Reserved.

25
TESTING.md Normal file
View File

@@ -0,0 +1,25 @@
## Unit Frontend
- `brew install phantomjs`
- `gulp karma`
## E2E Frontend
### On first run
- `gulp webdriver-update`
### Chrome Local STF
- Connect a device
- Run stf
- `gulp protractor`
### Multiple Browsers Local STF with a specific suite
- Connect a device
- Run stf
- `gulp protractor --multi --suite devices`
### Chrome Remote STF
- `export STF_URL='http://stf-url/#!/'`
- `export STF_USERNAME='user'`
- `export STF_PASSWORD='pass'`
- `gulp protractor`

6
UPDATING.md Normal file
View File

@@ -0,0 +1,6 @@
Updating
===
- `git pull`
- `npm install`
- `bower install`