Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Ahoyapps 30 readme #38

Merged
merged 24 commits into from
Jan 8, 2020
Merged

Ahoyapps 30 readme #38

merged 24 commits into from
Jan 8, 2020

Conversation

timmydoza
Copy link
Contributor

@timmydoza timmydoza commented Dec 20, 2019

Contributing to Twilio

All third party contributors acknowledge that any contributions they provide will be made under the same open source license that the open source project is provided under.

  • I acknowledge that all my contributions will be made under the project's license.

Pull Request Details

JIRA link(s):

Description

This PR adds a readme (to serve as a Getting Started guide) and a CHANGELOG.

Burndown

Before review

  • Updated CHANGELOG.md if necessary
  • Added unit tests if necessary
  • Updated affected documentation
  • Verified locally with npm test
  • Manually sanity tested running locally
  • Included screenshot as PR comment (if needed)
  • Ready for review

Before merge

  • Got one or more +1s
  • Re-tested if necessary

@timmydoza timmydoza self-assigned this Dec 20, 2019
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
Copy link
Contributor

@aaalaniz aaalaniz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice start!

CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated

One great way to learn about the room object is to explore it in the browser console. When you are connected to a room, the application will expose the room object as a window variable: `window.twilioRoom`.

Since the `room` object maintains all state that relates to the connected room, it isn't necessary to use a tool like Redux to track the state of the room. We can instead use the `room` object as our source of truth. One caveat is that we will need some way of triggering component re-renders in React. The `room` object and most child properties are [event emitters](https://nodejs.org/api/events.html#events_class_eventemitter), which means that we can subscribe to these events to update React components as the room state changes.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What are your thoughts on replacing these sentences

Since the room object maintains all state that relates to the connected room, it isn't necessary to use a tool like Redux to track the state of the room. We can instead use the room object as our source of truth. One caveat is that we will need some way of triggering component re-renders in React. The room object and most child properties are event emitters, which means that we can subscribe to these events to update React components as the room state changes.

with the following:

The Twilio Video JS SDK manages the room object state. As a result, the room object itself serves as the source of truth and a tool like Redux is not needed to track room state. However, a caveat presents itself for React applications that need to trigger component re-renders. The room object and most child properties are event emitters, which means that a React application can subscribe to these events to update components as the room state changes.

Copy link
Contributor Author

@timmydoza timmydoza Jan 6, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Went with something a little different here. What do you think?

Since the Twilio Video SDK manages the room object state, it can be used as the source of truth. It isn't necessary to use a tool like Redux to track the room state. The room object and most child properties are event emitters, which means that we can subscribe to these events to update React components as the room state changes.

LICENSE Outdated Show resolved Hide resolved
aaalaniz
aaalaniz previously approved these changes Jan 6, 2020
CHANGELOG.md Outdated
@@ -1,13 +1,12 @@
## 0.1.0

This release marks the first iteration of the Twilio Video Collaboration App: a canonical multi-party collaboration video application built with Programmable Video. This application is intended to demonstrate the capabilities of Programmable Video and serve as a reference to developers building video apps.
This release marks the first iteration of the Twilio Video Collaboration App: a canonical multi-party collaboration video application built with Programmable Video. This application demonstrates the capabilities of Programmable Video and serve as a reference to developers building video apps.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"serves" as a reference

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed - thanks


### `npm start`

This comment was marked as resolved.

@aymenn aymenn self-requested a review January 8, 2020 18:21
aymenn
aymenn previously requested changes Jan 8, 2020
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
aaalaniz
aaalaniz previously approved these changes Jan 8, 2020
@timmydoza timmydoza dismissed stale reviews from aymenn and charliesantos January 8, 2020 19:34

Changes have been applied -Aymen gave thumbs-up on slack

@timmydoza timmydoza merged commit a0c348d into development Jan 8, 2020
@timmydoza timmydoza deleted the AHOYAPPS-30-readme branch January 8, 2020 19:38
timmydoza pushed a commit that referenced this pull request Mar 6, 2020
* Update readme
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants