enaml icon indicating copy to clipboard operation
enaml copied to clipboard

Tutorials are incomplete

Open skorokithakis opened this issue 3 years ago • 5 comments

I just downloaded Enaml and am trying to follow the Person tutorial, but it's incomplete. It doesn't tell me how to name the files or how to run them, so I just get an error like this:

14:34:02 $ enaml-run lala.enaml
Could not find component 'Main'

In my opinion, tutorials should assume zero knowledge on the part of the reader, so the tutorial should tell me the names of the files and the command I need to see the UI.

skorokithakis avatar Sep 12 '22 11:09 skorokithakis

The tutorials are a bit different from the other examples in that one should run python hello_world.py to run the hello world example rather than going through enaml-run. This part has not been edited in a long time (before I took over the maintenance I think) and I missed the issue. I am sorry for the disagreement.

If you feel so inclined feel free to make a PR, otherwise I will do my best to update the docs ASAP.

MatthieuDartiailh avatar Sep 12 '22 11:09 MatthieuDartiailh

I'd make a PR, but I don't know how to run the example :P I mean, I don't know what the filenames should be.

skorokithakis avatar Sep 12 '22 11:09 skorokithakis

As mentionned in my previous comment to run hello_world call, with python, hello_world.py, person.py for the person tutorial and employee.py for the employee tutorial.

MatthieuDartiailh avatar Sep 12 '22 12:09 MatthieuDartiailh

Maybe something related to #460 ?

Kochise avatar Oct 02 '22 13:10 Kochise

#460 will make it easier to run the examples but does not address the documentation issue though.

I merged it nonetheless since it is an improvement over the status quo.

MatthieuDartiailh avatar Oct 06 '22 19:10 MatthieuDartiailh