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

readme and doc consolidation updates #408

Merged
merged 19 commits into from
Oct 16, 2017
Merged

Conversation

greggb
Copy link
Member

@greggb greggb commented Oct 14, 2017

What: Added some quick start info on main readme and consolidated some documentation.

Why: The docs need updating

Still a work in progress.
Todo:

  • mark all features that require babel in their respective doc files
  • N/A notes for each api item (future PR)
  • further doc consolidation

@tkh44
Copy link
Member

tkh44 commented Oct 14, 2017

Thank you so much Gregg. This is going to have a huge impact on our adoption.

@greggb
Copy link
Member Author

greggb commented Oct 15, 2017

I have some more WIP for another PR, but I think this is a good update on its own.

@greggb
Copy link
Member Author

greggb commented Oct 15, 2017

Mind giving it a look @tkh44 ?

@greggb greggb changed the title wip readme and doc consolidation updates readme and doc consolidation updates Oct 15, 2017
@@ -0,0 +1,36 @@
## Usage with Babel
Copy link
Contributor

Choose a reason for hiding this comment

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

@greggb @tkh44 there are quite a few babel options (e.g. sourcemaps, inline etc etc).. I think they should be documented here..

Copy link
Member Author

Choose a reason for hiding this comment

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

Absolutely - I'm not sure of all the options

### Features which are enabled with the babel plugin

### styled.element Syntax
`styled('div')` will work without the plugin
Copy link
Contributor

Choose a reason for hiding this comment

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

I'd like to see an explanation of the two syntax types and the reason for using one over the other. It probably should go in the 'getting started' section (if there is one..) though

Copy link
Member Author

Choose a reason for hiding this comment

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

I have a getting started doc on deck for my next PR. I'll need some help understanding the big differences between syntaxes

@tkh44
Copy link
Member

tkh44 commented Oct 15, 2017

I will look at this when I get some time today

@tkh44 tkh44 self-assigned this Oct 16, 2017
@tkh44 tkh44 merged commit 3973317 into emotion-js:master Oct 16, 2017
@greggb greggb deleted the update-readme branch October 16, 2017 14:04
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.

None yet

3 participants