Lack of Documentation

[horrido]

The lack of documentation, especially with respect to how to write Amber applications, is severely restricting newcomers (like myself) who want to try out Amber. There are no decent tutorials beyond the trivial "Hello World" or Counter app. Any examples that I've found have been too narrowly focused or specialized. In particular, there is precious little information on how to work with HTML and DOM elements (eg, how to work with forms). Amber seems to rely heavily on jQuery, so if this is the case, the documentation should explain how to go about interfacing with jQuery (and tell the reader that jQuery knowledge is mandatory).

[ghost]

Interfacing with jQuery is simply: "use asJQuery to obtain jQuery set and then just work with it using smalltalk selector to access property / call a method".

As you @horrido said in ML you are retired writer w/ lots of time, do you care to be part of the documentations / examples team?

[horrido]

Yes, I'd like to be part of the team. I will feel more confident about
contributing once I figure out how to write a proper Amber application.

On 21 December 2014 at 15:49, Herbert Vojčík notifications@github.com
wrote:

Interfacing with jQuery is simply: "use asJQuery to obtain jQuery set and
then just work with it using smalltalk selector to access property / call a
method".

As you d @horrido https://github.com/horrido said in ML you are retired
writer w/ lots of time, do you care to be part of the documentations /
examples team?

—
Reply to this email directly or view it on GitHub
#37 (comment)
.

[hhzl]

@horrido Richard, you mention as examples

• Hello Word App (now generated by amber init, so earlier explanations are obsolete)
• Counter

There are more examples in https://github.com/amber-smalltalk/amber-examples
and there is a ToDo app https://github.com/hhzl/Amber-ToDo-List

I suggest that you have a closer look at them and see if you can convert something to a tutorial.

[hhzl]

See also current work at https://github.com/philippeback/amber-book

[hhzl]

In terms of FAQ and glossary there is at the moment

• https://github.com/amber-smalltalk/amber/wiki/FAQ
• http://docs.amber-lang.net/faq.html
• http://docs.amber-lang.net/js-glossary.html

[sebastianconcept]

I'm reviewing the information architecture of these docs.
Many problems found.
We need to address coordinating efforts

@horrido can you check the email I've sent to the google group regarding to this? Thanks!

Also I take your offer on helping to review the copywriting.
Many of us are non-native english speakers and highly technical profile so I found lots of communication catastrophes all around.

We need to do better if we want to get somewhere