Possible additions

[miromeir]

I was excited to start using the shell, then struggled with reading the wiki.
I'll describe my process and the "barriers" i hit:

• The concept of children. had to look it up in gjs.
• What's the "flow" of components, think of the lifecycle in React.
• The setup attribute - the only mention in the wiki is:
  "A callback function to execute on self". What is "self" in this context? when does "self" gets executed/instanciated/rendered(whatever terms appropriate).

I suppose it's a lot clearer once you know gjs but assume your readers don't know what's going on there.
I'd love to learn more about this shell and translate the things i learn into more detailed wiki pages. any chance to chat with you guys to understand it better?
I've worked a lot with ReactJS, OpenGL, game engines, and the above is unclear to me, so i imagine it's hard for non-programmers as well.

EDIT: My next step was to examine the personal widgets uploaded there, and couldn't understand parts of the code using the wiki.

[Aylur]

any chance to chat with you guys

you can join our discord server, we have some active people who will help you with any question

I added explanations for setup and attribute props
I'll think of a way to explain children and lifecycles later

[miromeir]

Thanks, will join.