Documentation

[slimsag]

This should include extensive documentation, including at least:

• [ ] A tutorial / walkthrough.
• [ ] DOM Operations
• [ ] Components
• [ ] Rendering (+rendering nothing)
• [ ] Diffing
• [ ] Safety
• [ ] Sharing code between frontend/backend
• [ ] Communicating with a REST endpoint.
• [ ] FAQ (Why Vecty doesn't support SSR, whether or not it's being used in production).
• [ ] Recommendation about server<->browser data transfer
• [ ] How to test Vecty projects
• [ ] Styling components (if we use non-std-CSS architecture)
• [ ] Live code reloading / asset embedding
• [ ] Redux pattern standard, dispatcher package usage.

Things that commonly trip people up which would also be good to discuss somewhere:

• [ ] An example about DefaultValue for <input>.

[ghost]

:) Even just the briefest would be cool..

[anxiousmodernman]

I've sketched a very basic "hello world" tutorial here: https://github.com/gloriousfutureio/vecty/blob/31_docs/docs/TUTORIAL.md

The tutorial should focus on Vecty concepts and be short

• no external css/js
• demonstrate Component declaration, reuse
• demonstrate how components are just structs, use custom fields
• demonstrate conditionals
• basic state management?

I'm a fan of go-kit's approach with their stringsvc tutorial. We can start smaller than that.

I'm still new to Vecty and gopherjs myself, so I figured I could write some docs as I go.

[anxiousmodernman]

@slimsag Has an outline for docs contribution on the docfest branch https://github.com/gopherjs/vecty/blob/docfest/docs/index.md#vecty-introduction