Skip to content

docs(README): List supported environments, add badges, and more #136

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

Merged
merged 35 commits into from
Jul 3, 2018

Conversation

spencerwilson-optimizely
Copy link
Contributor

@spencerwilson-optimizely spencerwilson-optimizely commented Jun 29, 2018

Summary

  • Add the same Full Stack description to the top of the READMEs here that @jonslaught advised to for python-sdk in Updating description and adding long description python-sdk#124
  • Clarify Lerna usage: no multiple packages, for now
  • Fix stale package name in root readme, and fix the NPM badge that also was based on it
  • Add badges to @optimizely/optimizely-sdk's README
  • Precisely document supported JavaScript environments
  • Add note about default EventDispatchers. (I have mixed feelings on this; happy to hear opinions)
  • Make Contributing section more concise
  • Drop references to dist/ artifacts, since chore(package): Delete unused build scripts #135 made them no longer a thing

Rendered

@coveralls
Copy link

coveralls commented Jun 29, 2018

Coverage Status

Coverage remained the same at 97.11% when pulling 7956534 on sw/readme into 4273292 on master.

@spencerwilson-optimizely spencerwilson-optimizely changed the title docs(README): Update docs(README): Describe support environments, add badges, and more Jun 30, 2018
@spencerwilson-optimizely spencerwilson-optimizely changed the title docs(README): Describe support environments, add badges, and more docs(README): List supported environments, add badges, and more Jun 30, 2018
.travis.yml Outdated
script: npm run test-xbrowser
script:
- npm test
- NODE_MAJOR=$(node -v | cut -c 2- | cut -d '.' -f 1)
Copy link
Contributor

Choose a reason for hiding this comment

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

There's an easier way to do this, I think, using the matrix config include: https://docs.travis-ci.com/user/customizing-the-build#Explicitly-Including-Jobs

@spencerwilson-optimizely
Copy link
Contributor Author

Okay, up-to-date with master once again and ready for review.


The SDK is available through [npm](https://npmjs.com/package/optimizely-sdk). To install:
Ensure the SDK supports all of the platforms you're targeting. In particular, we support any ES5-compliant JavaScript environment, including
- Node.js >= 4.0.0. By extension, environments like AWS Lambda, Google Cloud Functions, and Auth0 Webtasks are supported as well. Older Node.js releases likely work too (try `npm test` to validate for yourself), but are not formally supported.
Copy link
Contributor

Choose a reason for hiding this comment

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

nice


The SDK is available through [npm](https://npmjs.com/package/optimizely-sdk). To install:
Ensure the SDK supports all of the platforms you're targeting. In particular, we support any ES5-compliant JavaScript environment, including
Copy link
Contributor

Choose a reason for hiding this comment

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

I wonder if we can write this a little more precisely so as not to imply supported (as in we'll fix platform-specific issues for that platform) but merely will probably work.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good point, I'll try to work something out.


- We no longer support legacy Node versions (under 4.0).
- We no longer support Node.js < 4.0.0, which [reached end-of-life](https://github.com/nodejs/Release#end-of-life-releases) 2016-12-31.
Copy link
Contributor

Choose a reason for hiding this comment

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

Super nit: by 2016-12-31 would make it true for both 0.10 and 0.12. Reads kind of weird though.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

hah, yeah. Maybe

which collectively reached end-of-life 2016-12-31.

- Node.js >= 4.0.0. By extension, environments like AWS Lambda, Google Cloud Functions, and Auth0 Webtasks are supported as well. Older Node.js releases likely work too (try `npm test` to validate for yourself), but are not formally supported.
- [Web browsers](https://caniuse.com/#feat=es5)

Other environments likely are compatible, too, but note that we don't officially support them:
Copy link
Contributor

Choose a reason for hiding this comment

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

Would it be worth mentioning hybrid mobile environments like Cordova (+ Phonegap) and others like React Native?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ooh good call, will add

@spencerwilson-optimizely spencerwilson-optimizely merged commit fbbf9f8 into master Jul 3, 2018
@spencerwilson-optimizely spencerwilson-optimizely deleted the sw/readme branch July 3, 2018 22:24
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.

4 participants