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

Updated Read Me & Documentation in the code. #16

Merged
merged 19 commits into from
Sep 13, 2016

Conversation

KaySackey
Copy link
Contributor

My general aim was to make all the code examples in the README file into valid javascript.

I also wanted to make the longer form code examples that weren't part of document-gem (e.g. the quick start and the putting it all together), into something that could be executed directly w/o having to write any additional code. I tried my best to keep the 'spirit' of the code but if i erred in that, please tell me.

Additionally:

  1. I added typedefs to the JSDoc so (a) it'll work with IDEs that don't understand typescript typings; and when DocumentationJS is fixed to print out typedefs as well; it'll automatically add them to the documentation with proper linking.
  2. Lastly, I removed any reference in the examples to deprecated functions like ref() / child().
  3. I expanded on the spelling corrections in patch polished readme #15; and made changes in the code-comments to support this.

Hope this helps. If you only want to use some of this, I can parcel that into a digestible chunk.

This is so we can get code-completion & basic type checking in
environments that don't use the typescript definitions file.
Added notes about where/when decorators work in Babel 5.x
Also added info on how to enable decorators in 5.x (lots of people
still use 5.x due to JSPM still using it)
Rationale: It's nice to be able to copy the quick start into a file,
and just run it and see a result.
This is so we can get code-completion & basic type checking in
environments that don't use the typescript definitions file.
Added notes about where/when decorators work in Babel 5.x
Also added info on how to enable decorators in 5.x (lots of people
still use 5.x due to JSPM still using it)
Rationale: It's nice to be able to copy the quick start into a file,
and just run it and see a result.
Applying patches from vonovak @ mobxjs#15
Added changes to the documentation within code
{*} is render as Any in the documentation, and now JSdoc inferences
work normally with editors that use them.

The top section of typedefs wasn't being picked up by IntelliJ because
of the formatting.

Property names in the documentation now match their real name in the
code.
@coveralls
Copy link

Coverage Status

Coverage remained the same at 94.048% when pulling 525cf42 on KaySackey:master into f971d87 on mobxjs:master.

@vonovak vonovak mentioned this pull request Sep 6, 2016
@mweststrate
Copy link
Member

This is awesome, thans a lot! (and sorry for the late follow up!)

@mweststrate mweststrate merged commit 3d85bdd into mobxjs:master Sep 13, 2016
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