Skip to content

Commit

Permalink
Remove generated API docs from the README
Browse files Browse the repository at this point in the history
  • Loading branch information
imaustink committed Aug 24, 2017
1 parent 1c41658 commit d3affc9
Show file tree
Hide file tree
Showing 2 changed files with 112 additions and 2 deletions.
85 changes: 85 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
# Contributing to can-define-stream-kefir

Check out the [contribution guide on CanJS.com](https://canjs.com/doc/guides/contribute.html) for information on:

- [Code of Conduct](https://canjs.com/doc/guides/contribute.html#CodeofConduct)
- [Getting Help](https://canjs.com/doc/guides/contribute.html#GettingHelp)
- [Project Organization](https://canjs.com/doc/guides/contributing/project-organization.html)
- [Reporting Bugs](https://canjs.com/doc/guides/contributing/bug-report.html)
- [Suggesting Features](https://canjs.com/doc/guides/contributing/feature-suggestion.html)
- [Finding Ways to Contribute](https://canjs.com/doc/guides/contributing/finding-ways-to-contribute.html)

The rest of this guide has information that’s specific to this repository.

## Developing Locally

This section will walk you through setting up the [repository](https://github.com/canjs/can-define-stream-kefir) on your computer.

### Signing up for GitHub

If you don’t already have a GitHub account, you’ll need to [create a new one](https://help.github.com/articles/signing-up-for-a-new-github-account/).

### Forking & cloning the repository

A “fork” is a copy of a repository in your personal GitHub account. “Cloning” is the process of getting the repository’s source code on your computer.

GitHub has a guide for [forking a repo](https://help.github.com/articles/fork-a-repo/). To fork can-define-stream-kefir, you can start by going to its [fork page](https://github.com/canjs/can-define-stream-kefir/fork).

Next, you’ll want to clone the repo. [GitHub’s cloning guide](https://help.github.com/articles/cloning-a-repository/) explains how to do this on Linux, Mac, or Windows.

GitHub’s guide will [instruct you](https://help.github.com/articles/fork-a-repo/#step-2-create-a-local-clone-of-your-fork) to clone it with a command like:

```shell
git clone https://github.com/YOUR-USERNAME/can-define-stream-kefir
```

Make sure you replace `YOUR-USERNAME` with your GitHub username.

### Installing the dependencies

After you’ve forked & cloned the repository, you’ll need to install the project’s dependencies.

First, make sure you’ve [installed Node.js and npm](https://docs.npmjs.com/getting-started/installing-node).

If you just cloned the repo from the command line, you’ll want to switch to the folder with your clone:

```shell
cd can-define-stream-kefir
```

Next, install the project’s dependencies with npm:

```shell
npm install
```

### Starting the development server

Run the following to start a dev server:

```shell
npm run develop
```

### Running the tests

You can manually run this repository’s tests in any browser by starting the dev server (see the section above) and visiting this page: http://localhost:8080/test/test.html

Firefox is used to run the repository’s automated tests from the command line. If you don’t already have it, [download Firefox](https://www.mozilla.org/en-US/firefox/new/). Mozilla has guides for installing it on [Linux](https://support.mozilla.org/t5/Install-and-Update/Install-Firefox-on-Linux/ta-p/2516), [Mac](https://support.mozilla.org/t5/Install-and-Update/How-to-download-and-install-Firefox-on-Mac/ta-p/3453), and [Windows](https://support.mozilla.org/t5/Install-and-Update/How-to-download-and-install-Firefox-on-Windows/ta-p/2210).

After Firefox is installed, you can run:

```shell
npm test
```

### Making a build

Run the following command to create a build:

```shell
npm run build
```

This will create a `dist/` folder that contains the AMD, CommonJS, and global module versions of the project.

29 changes: 27 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,28 @@
Adds the ability to define properties with streams on can-define types.
# can-define-stream-kefir

[![Join the chat at https://gitter.im/canjs/canjs](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/canjs/canjs?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/canjs/can-define-stream-kefir/blob/master/LICENSE)
[![npm version](https://badge.fury.io/js/can-define-stream-kefir.svg)](https://www.npmjs.com/package/can-define-stream-kefir)
[![Travis build status](https://travis-ci.org/canjs/can-define-stream-kefir.svg?branch=master)](https://travis-ci.org/canjs/can-define-stream-kefir)
[![AppVeyor build status](https://ci.appveyor.com/api/projects/status/github/canjs/can-define-stream-kefir?branch=master&svg=true)](https://ci.appveyor.com/project/matthewp/can-define-stream-kefir)
[![Coverage status](https://coveralls.io/repos/github/canjs/can-define-stream-kefir/badge.svg?branch=master)](https://coveralls.io/github/canjs/can-define-stream-kefir?branch=master)
[![Greenkeeper badge](https://badges.greenkeeper.io/canjs/can-define-stream-kefir.svg)](https://greenkeeper.io/)

FAILED TO GET DESCRIPTION

## Documentation

Read the [can-define-stream-kefir API docs on CanJS.com](https://canjs.com/doc/can-define-stream-kefir.html).

## Changelog

See the [latest releases on GitHub](https://github.com/canjs/can-define-stream-kefir/releases).

## Contributing

The [contribution guide](https://github.com/canjs/can-define-stream-kefir/blob/master/CONTRIBUTING.md) has information on getting help, reporting bugs, developing locally, and more.

## License

[MIT](https://github.com/canjs/can-define-stream-kefir/blob/master/LICENSE)

[Read more in the CanJS Docs](https://canjs.com/doc/can-define-stream-kefir.html)

0 comments on commit d3affc9

Please sign in to comment.