Skip to content
This repository was archived by the owner on Feb 15, 2023. It is now read-only.

Commit 1d26349

Browse files
committed
Tidied up readme documentation references and added Stream to copyright holders
1 parent 8bc9d0e commit 1d26349

File tree

2 files changed

+49
-44
lines changed

2 files changed

+49
-44
lines changed

LICENSE

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,27 @@
1-
Copyright (c) 2015, Stream.io INC
1+
Copyright (c) 2015-2017 Stream.io Inc, and individual contributors.
2+
23
All rights reserved.
3-
4-
Redistribution and use in source and binary forms, with or without
5-
modification, are permitted provided that the following conditions are met:
6-
7-
* Redistributions of source code must retain the above copyright notice, this
8-
list of conditions and the following disclaimer.
9-
10-
* Redistributions in binary form must reproduce the above copyright notice,
11-
this list of conditions and the following disclaimer in the documentation
12-
and/or other materials provided with the distribution.
13-
14-
* Neither the name of Stream.io INC nor the names of its
15-
contributors may be used to endorse or promote products derived from
16-
this software without specific prior written permission.
17-
18-
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19-
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20-
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21-
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
22-
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23-
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
24-
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
25-
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
26-
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27-
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
4+
5+
Redistribution and use in source and binary forms, with or without modification, are permitted
6+
provided that the following conditions are met:
7+
8+
1. Redistributions of source code must retain the above copyright notice, this list of
9+
conditions and the following disclaimer.
10+
11+
2. Redistributions in binary form must reproduce the above copyright notice, this list of
12+
conditions and the following disclaimer in the documentation and/or other materials
13+
provided with the distribution.
14+
15+
3. Neither the name of the copyright holder nor the names of its contributors may
16+
be used to endorse or promote products derived from this software without specific prior
17+
written permission.
18+
19+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
20+
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
21+
AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
22+
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23+
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
24+
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25+
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
26+
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27+
POSSIBILITY OF SUCH DAMAGE.

README.md

Lines changed: 23 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,15 @@
1-
##Stream NodeJS
1+
## Stream Node.js
22

33
[![Build Status](https://travis-ci.org/tbarbugli/stream-node.svg)](https://travis-ci.org/tbarbugli/stream-node)
44
[![npm version](https://badge.fury.io/js/getstream-node.svg)](http://badge.fury.io/js/getstream-node)
55

6-
This package helps you create activity streams & newsfeeds with NodeJS and [GetStream.io](https://getstream.io).
6+
[stream-node-orm](https://github.com/GetStream/stream-node-orm) is a Node.js (Sails, Waterline) client for [Stream](https://getstream.io/).
77

8-
###Build activity streams & news feeds
8+
You can sign up for a Stream account at https://getstream.io/get_started.
9+
10+
Note there is also a lower level [Node.js - Stream integration](https://github.com/getstream/stream-js) library which is suitable for all JavaScript applications.
11+
12+
### Build activity streams & news feeds
913

1014
<p align="center">
1115
<img src="https://dvqg2dogggmn6.cloudfront.net/images/mood-home.png" alt="Examples of what you can build" title="What you can build"/>
@@ -40,7 +44,7 @@ Install getstream_node package with npm:
4044

4145
#### Step 2 - Config file
4246

43-
Copy `getstream.js` config file from `node_modules/getstream-node` into the root directory of your application
47+
Copy `getstream.js` config file from `node_modules/getstream-node` into the root directory of your application
4448
Make sure you require the getstream-node early on in your application (eg. in app.js)
4549

4650
#### Step 3 - Get your API key
@@ -50,7 +54,7 @@ Login with Github on [getstream.io](https://getstream.io/) and edit the configur
5054

5155
###Model integration
5256

53-
Stream Nodejs can automatically publish new activities to your feeds. To do that you only need to register the models you want to publish with this library.
57+
Stream Node.js can automatically publish new activities to your feeds. To do that you only need to register the models you want to publish with this library.
5458

5559
```js
5660
var stream = require('getstream-node');
@@ -73,8 +77,8 @@ Every time a Tweet is created it will be added to the user's feed. Users which f
7377
Models are stored in feeds as activities. An activity is composed of at least the following fields: **actor**, **verb**, **object**, **time**. You can also add more custom data if needed.
7478
The Activity mixin will try to set things up automatically:
7579

76-
**object** is a reference to the model instance
77-
**actor** is a reference to the user attribute of the instance
80+
**object** is a reference to the model instance
81+
**actor** is a reference to the user attribute of the instance
7882
**verb** is a string representation of the class name
7983

8084
By default the actor field will look for an attribute called user or actor and a field called created_at to track creation time.
@@ -121,18 +125,18 @@ tweetSchema.methods.createActivity = function() {
121125

122126
###Feed manager
123127

124-
This packages comes with a feed_manager class that helps with all common feed operations.
128+
This packages comes with a feed_manager class that helps with all common feed operations.
125129

126130
####Feeds bundled with feed_manager
127131

128132
To get you started the manager has 4 feeds pre-configured. You can add more feeds if your application needs it.
129133
The three feeds are divided in three categories.
130134

131135
#####User feed:
132-
The user feed stores all activities for a user. Think of it as your personal Facebook page. You can easily get this feed from the manager.
136+
The user feed stores all activities for a user. Think of it as your personal Facebook page. You can easily get this feed from the manager.
133137
```js
134138
FeedManager.getUserFeed(req.user.id);
135-
```
139+
```
136140

137141
#####News feeds:
138142
The news feeds store the activities from the people you follow.
@@ -205,7 +209,7 @@ router.get('/flat', ensureAuthenticated, function(req, res, next){
205209
.then(function (enrichedActivities) {
206210
return res.render('feed', {location: 'feed', user: req.user, activities: enrichedActivities, path: req.url});
207211
})
208-
.catch(next)
212+
.catch(next)
209213
});
210214
});
211215
```
@@ -230,20 +234,16 @@ tweetSchema.statics.pathsToPopulate = function() {
230234
};
231235
```
232236

237+
### Full documentation and Low level APIs access
233238

234-
235-
### Low level APIs access
236-
237-
You can also use the low level JS API directly.
239+
When needed you can also use the [low level JavaScript API](https://github.com/getstream/stream-js) directly. Documentation is available at the [Stream website](https://getstream.io/docs/?language=js).
238240

239241
```js
240242
var streamNode = require('getstream-node');
241243
var client = streamNode.FeedManager.client
242244
// client.addActivity, client.removeActivity etc are all available
243245
```
244246

245-
The full documentation for the low level API is available in the [getstream.io documentation](https://getstream.io/docs/).
246-
247247
### Enrichment
248248

249249
You can use the enrichment capabilities of this library directly.
@@ -264,7 +264,7 @@ streamWaterline.enrichActivities(activities).then(function(enrichedActivities) {
264264

265265
### Customizing enrichment (since 1.4.0)
266266

267-
By default the enrichment system assumes that you're referencing items by their id. Sometimes you'll want to customize this behaviour. You might for instance use a username instead of an id. Alternatively you might mant to use a caching layer instead of the ORM for loading the data. The example below shows how to customize the lookup for all User entries.
267+
By default the enrichment system assumes that you're referencing items by their id. Sometimes you'll want to customize this behaviour. You might for instance use a username instead of an id. Alternatively you might mant to use a caching layer instead of the ORM for loading the data. The example below shows how to customize the lookup for all User entries.
268268

269269
```js
270270
// subclass streamMongoose
@@ -292,3 +292,8 @@ streamCustomEnrichment.prototype = {
292292
util.inherits(streamCustomEnrichment, streamNode.mongoose.Backend);
293293
```
294294

295+
### Copyright and License Information
296+
297+
Copyright (c) 2015-2017 Stream.io Inc, and individual contributors. All rights reserved.
298+
299+
See the file "LICENSE" for information on the history of this software, terms & conditions for usage, and a DISCLAIMER OF ALL WARRANTIES.

0 commit comments

Comments
 (0)