Skip to content

The https://dioxuslabs.com/learn/0.7/tutorial/ content fails the "type it and it runs" test #595

@drdozer

Description

@drdozer

I have been working through the tutorial. Up to https://dioxuslabs.com/learn/0.7/tutorial/new_app everything was fine. From then on all the wheels fell off. The code snippets are too sparse to actually join up into a functioning app. There isn't any clear indication what snippets I should be adding to my source tree, and which are illustrative and should be read only. It tells me to put various code into various files, but to make anything work I have to either put it in main.rs or monkey with imports. Some of it won't compile at all, presumably due to unstated imports. I could muddle through, but perhaps I can be more useful helping to fix the content so muddling isn't required?

IMHO, the tutorial should ideally work first time for everyone. So each step to make it work needs to be spelled out. The content that is only to be read should be flagged as such. If code is intended to be put into particular files, then it needs to also give the imports in those files and the code in main.rs to hook it in. Screenshots of the IDE+app should be matching up with the code snippets.

I'm not quite sure where to start. I would be happy to pair with someone in the documentation project to work through this stuff step by step. I just finished working through the spacetime db tutorials, and they are good examples of high-quality "type it and it runs"-style tutorial projects.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions