PerlDancer / Dancer2

Perl Dancer Next Generation (rewrite of Perl Dancer)
http://perldancer.org/
Other
543 stars 274 forks source link

Use Dancer2 standards in tutorial #1293

Open racke opened 7 years ago

racke commented 7 years ago

Especially https://metacpan.org/pod/distribution/Dancer2/lib/Dancer2/Tutorial.pod#Putting-it-all-together is bad and confuses new users. - just in a discussion with an unlucky person who followed that part.

So:

We really don't need to save place in our tutorial by lumping it altogether instead of where the code / config belongs.

Knemon commented 7 years ago

Dancer2::Tutorial is where new users try to learn how to get started with Dancer2 - the techniques demonstrated are not be used unless you know what you are doing - in this case its highly possible you may not need to read this guide.

I started my app using this example and I was quite happy until I had to do some extra customization and configuration. Then I realized I took the wrong path and I had to migrate my code to a new project properly generated using dancer2 -a project.

I agree with racke, his suggestion could probably create more value in the content of this guide.

sdondley commented 6 years ago

I think it would be a good idea to add a final section to the end of this tutorial showing how to move from the script in the "Putting it all together" section to an app generated by the dancer2 script and proper module.

I kind of like the idea of starting with a *.pl file. It strips things down to its essence. And then you can show the user that "hey, look, there's an even better and easier way to do this" using the dancer2 command.

sdondley commented 6 years ago

OK, grabbed. Let me know what you think. Thanks.

ccntrq commented 4 years ago

Hey,

I'm just going through the issues. I think this one can be closed. The changes made by @sdondley in #1425 address the issues described here and were merged into the master branch in April.