choojs/choo-handbook

[guide] Choo Introduction For People Who Know Just Enough jQuery To Get By

Open

#22 opened on Aug 2, 2016

View on GitHub
 (1 comment) (0 reactions) (0 assignees)HTML (268 stars) (25 forks)batch import
help wanted

Description

@kriesse pointed out today that it'd be cool to have a choo introduction geared at people with light frontend skills (e.g. designers). An article that she particularly liked was react introduction for people who know just enough jquery to get by. It'd be cool if something like that existed for choo.

The structure of the article is roughly:

  • define the target audience
  • overview of the project (create a tweet box)
  • introduction to JSBin (load libs and stuff, get some html)
  • set some state on the button in jquery
  • explain what you'll be doing in react to do the same thing
  • write some HTML markup in react
  • set some default state on the button using react (button is "disabled")
  • implement some state toggling in react
  • add a "remaining character count" thingy with jQuery
  • add a "remaining character count" thingy with react
  • explain the "add photo" feature
  • create the "add photo" button in jQuery
  • create the "add photo" button in react
  • reflecting on the react code (what makes it good?)
  • explain the "highlight overflow characters" feature
  • highlight "overflow characters" using react

Help with this is super welcome! - It'd be cool if someone (or a group of people) could help guide absolute beginners to feel comfortable writing bel / choo code! I probably won't have time to do this in the coming months, so if someone else could pick it up it'd be amazing :sparkles: Thanks!

Contributor guide

Tech stack
javascripthtml
Domain
documentationcontent
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
familiarity with choo frameworkknowledge of jQuery basicsbasic JavaScript
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60
Research direction
The issue requests a beginner guide for choo, similar to a React intro for jQuery users. Start by reviewing the linked React for Designers article to understand the structure and tone. Then, create a choo version with the same steps: define audience, build a tweet box, compare jQuery and choo implementations, and cover state, character count, add photo, and overflow highlighting. Use JSBin for live examples. Check the choo handbook repo for existing guides and ensure consistency. Since the issue is old, consider commenting to confirm interest before starting.