Improve docs examples: simple to complex

[treshugart]

A comment on hacker news pointed out that the docs should start out a little bit simpler and go to more complex. Currently, there's a couple examples but they are very similar. Coming from web components and seeing Skate, one might not know what render() means right off the bat and may need some explanation. While we don't want to detract those coming from a React (i.e. render() world, examples starting simple and employing some of the spec'd stuff before introducing it might fare better.

More info: https://news.ycombinator.com/item?id=12862025

[Hotell]

As I've suggested by person in London 😉 I think it would be very nice to port docs to gitbook and have similar experience like "readers" of redux or ngMetadata have. I'm here to help with this. just lemme know if you think it's good idea and wanna proceed.

[treshugart]

Yeah, more than happy to do that. I think it would be simpler than maintaining a website, though, the website is a great as a suite of example components. But dev speed > website IMO, so go for it!

[ghost]

Personally, I'd like to add an example of rxjs and skatejs (stateless components).

[treshugart]

@haoxins that's a great idea. I haven't had a chance to use RXJS yet, but if anyone has, I'd be really interested how this might work out.

[pyrossh]

I think integrations with redux, mobx or even relay(v2) might help new users to use skatejs as a complete frontend solution as a replacement to react or angular.

[jeznag]

Would be great to add docs on the toolchain required. I can't figure out how to get this example going: https://hackernoon.com/building-a-custom-tag-input-with-skate-js-fbd4cdf744f#.5pmuikday

I get this error:

There's probably some obvious webpack/babel plugin to use. Is it just the JSX loader?

[treshugart]

@jeznag replied via Twitter. See https://skatejs.gitbooks.io/skatejs/content/docs/api/#jsx. You don't need any special tools if you're doing raw JS. If you want to use JSX, you have to enable it.