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

more explicit usage docs #404

Merged
merged 2 commits into from
Jan 4, 2017
Merged

more explicit usage docs #404

merged 2 commits into from
Jan 4, 2017

Conversation

giladgray
Copy link
Contributor

@giladgray giladgray commented Jan 3, 2017

Fixes #190, Fixes #201

Changes proposed in this pull request:

  • a significant refactor of the two Usage sections
  • Overview Usage is now mostly a link to Components Usage that scratches the peer dep itch
  • Components Usage steps through setting up BP with peer deps and CSS imports
  • new section about DOM4 so we can point folks to it

Reviewers should focus on:

  • copy editing! the DOM4 section feels pretty awkward

peer dependencies, CSS imports, DOM4 existence.
the DOM4 section feels pretty awkward but at least it's there.
@blueprint-bot
Copy link

more explicit usage docs

Preview: docs
Coverage: core | datetime

Copy link
Contributor

@adidahiya adidahiya left a comment

Choose a reason for hiding this comment

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

Overall looks pretty good

// using the namespace import
const anotherSpinner = <Blueprint.Spinner/>;
Blueprint relies on a handful of DOM Level 4 API methods: `el.query`, `el.queryAll`, and `el.closest()`.
We depend on a [polyfill library called `dom4`][dom4] to ensure these methods are always available.
Copy link
Contributor

Choose a reason for hiding this comment

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

  • "We depend" -> "@blueprintjs/core depends"
  • "are always available." -> "are available."

// use factories for React.createElement shorthand if you're not using JSX
const myDatePicker = DatePickerFactory();
```
If you consume Blueprint through a module bundler such as Webpack then everything should work swimmingly.
Copy link
Contributor

Choose a reason for hiding this comment

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

I would just remove this paragraph and add a line to the previous paragraph: "This module is conditionally loaded if Blueprint is used in a browser environment."

@adidahiya adidahiya requested a review from eparish January 4, 2017 18:47
Copy link
Contributor

@eparish eparish left a comment

Choose a reason for hiding this comment

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

Looks good!

@blueprint-bot
Copy link

mention dom4 conditional loading

Preview: docs | table
Coverage: core | datetime

@adidahiya adidahiya merged commit 7d6bd4d into master Jan 4, 2017
@adidahiya adidahiya deleted the gg/usage branch January 4, 2017 23:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants