aylur / ags-docs Goto Github PK

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.

prod:

local:

this breaks relative links, but i cant reproduce it so no idea whats happening

The documentation should probably have something about Aylur/ags#75 (bar not working without env var set as such) in the "Common Issues" section.

By going to https://aylur.github.io/ags-docs/ then press "Get Started", it will drive me to:
https://aylur.github.io/ags-docs/config/installation/
I think it should be:
https://aylur.github.io/ags-docs/config/installation.html

Thanks for the great tool and docs!