800573 - Create 'L20n by example'

Status: RESOLVED FIXED

(L20n :: Evangelism, defect, P2)

Description

[Staś Małolepszy :stas]

I'm inspired by https://gobyexample.com/.  Read more about it here:

http://mmcgrana.github.com/2012/10/introducing-go-by-example.html

It would be great to have a repository of examples like this for L20n.  We actually have something similar:  https://wiki.mozilla.org/L20n/Toolbox but it's outdated and would need to be rewritten in part.

Looking at https://gobyexample.com/arrays it's actually quite similar to our docs (generated by docco):

http://l20n.github.com/l20n.js/lib/l20n.html

Comment 1

[Zibi Braniecki [:zbraniecki][:gandalf]]

some ideas on how to show code: http://worrydream.com/LearnableProgramming/

Comment 2

[Staś Małolepszy :stas]

Yeah, I really really like what Bret Victor does to code.  It's outstanding.

Here's a different, not as good, but pretty okay, example:

http://code.hazzens.com/d3tut/lesson_1.html

On the other hand, let's not let our docs look like this:

http://code.google.com/p/crack-language/

Comment 3

[Jeff Beatty [:gueroJeff]]

Language for syntax highlighting: closure

Comment 4

[Staś Małolepszy :stas]

Assigning to myself.  I'll try to write 5 more chapters this week.

I'm working in the following etherpad:

    https://l20n.etherpad.mozilla.org/byexample

Comment 5

[Zibi Braniecki [:zbraniecki][:gandalf]]

another inspiration http://pcottle.github.io/learnGitBranching/

Comment 6

[Staś Małolepszy :stas]

also, http://tylerneylon.com/a/learn-lua/

Comment 7

[Zibi Braniecki [:zbraniecki][:gandalf]]

another http://worrydream.com/Tangle/

Comment 8

[Staś Małolepszy :stas]

Matjaž added the remaining chapter, but the appendices remain to be written.

Comment 9

[Matjaz Horvat [:mathjazz]]

Appendices are now also written:
https://github.com/l20n/l20n.org/commit/8babe5c326cdee38d11ab5c57c70893a1d2a1921

I think we should join the following two chapters, they are solving the same problem:
http://l20n.org/learn/context-data-and-localization-logic/
http://l20n.org/learn/genders/

We should just remove the second one and name the first one Genders as suggested in bug 916353.

Comment 10

[Staś Małolepszy :stas]

Now that bug 916353 is fixed, I think we can fix this one too?