During a beta testing session, the user needed help to follow step 1 of the Core Getting Started and found it too hard to understand.
Step 1, even if perfectly followed, does not work and needs to be updated.
Here are the reported issues:
This gif is way too long to follow:
There are too many steps for a single page; these steps should be separated:
The steps are not detailed enough: "Open Taipy Studio view" was not understood and should be "Open the Taipy Extension window located on the left panel of VSCode". It should also have a screenshot or a Gif to help
The tutorial does not clearly state that the following code should be put in a main.py file:
Even when following the tutorial and putting the function in a main.py file, the config file detects it as main and then complains that it can't find it when executing the scenario from a notebook (this works in scripts) (I will clarify this in another issue):
Defining default_data = 21 in Taipy Studio defines 21 as a string which results in double("21") = "2121":
This step took 30mins and required external help for some of the help
Conclusion: Step 1 should be rewritten into multiple simple steps, clearly written and using images or gifs at each step
Step 1 does not remind us that Taipy Studio is a VSCode extension that needs to be installed and then opened in the left panel of VSCode which stuck one of the testers
During a beta testing session, the user needed help to follow step 1 of the Core Getting Started and found it too hard to understand.
Step 1, even if perfectly followed, does not work and needs to be updated.
Here are the reported issues:
This gif is way too long to follow:
There are too many steps for a single page; these steps should be separated:
The steps are not detailed enough: "Open Taipy Studio view" was not understood and should be "Open the Taipy Extension window located on the left panel of VSCode". It should also have a screenshot or a Gif to help
The tutorial does not clearly state that the following code should be put in a main.py file:
Even when following the tutorial and putting the function in a main.py file, the config file detects it as main and then complains that it can't find it when executing the scenario from a notebook (this works in scripts) (I will clarify this in another issue):
Defining default_data = 21 in Taipy Studio defines 21 as a string which results in double("21") = "2121":
This step took 30mins and required external help for some of the help
Conclusion: Step 1 should be rewritten into multiple simple steps, clearly written and using images or gifs at each step