On 12/22/20 2:39 PM, Jason A. Crome wrote: > I’ve wanted to make a separate manual page just for the DSL for some time. > This now seems like a great opportunity to > make it happen. > > There is a doc overhaul in the works, and one of the things missing from it > was an index of the DSL keywords. This will > help that project along too. > > Great call on the test, racke. >
Here we go: https://github.com/PerlDancer/Dancer2/pull/1570 (Add test to check whether all DSL keywords appear in the manual). BTW: did we cover Dancer testing in the past advent calendars? Regards Racke > I am happy to make an issue in GitHub out of this when we wrap discussion up > here. Or I can add one now and we can move > the discussion there. > > Jason > > On Tue, Dec 22, 2020, at 5:08 AM, Stefan Hornburg (Racke) wrote: >> On 12/22/20 10:42 AM, Gabor Szabo wrote: >> > Hi, >> > >> > Let's separate this thread as this is a technical issue. >> > >> > Dancer2::Core::DSL might contain the definite list, but I , as a regular >> > user, don't see it I don't see it in the >> > documentation. My suggestion would be either to list them in the POD of >> > Dancer2::Core::DSL or include a link to >> > >> >https://metacpan.org/pod/distribution/Dancer2/lib/Dancer2/Manual.pod#DSL-KEYWORDS >> <https://metacpan.org/pod/distribution/Dancer2/lib/Dancer2/Manual.pod#DSL-KEYWORDS> >> > <https://metacpan.org/pod/distribution/Dancer2/lib/Dancer2/Manual.pod#DSL-KEYWORDS >> <https://metacpan.org/pod/distribution/Dancer2/lib/Dancer2/Manual.pod#DSL-KEYWORDS>> >> as that's where they are documented. >> > >> > Gabor >> >> Hello Gabor, >> >> I think we need to check which DSL keywords from Dancer2::Core::DSL are >> missing in the manual and add the documentation >> for those items. >> >> The check could be automated and part of the test suite. >> >> Regards >> Racke >> >> > >> > On Mon, Dec 21, 2020 at 12:43 PM Russell Jenkins >> > <[email protected] >> <mailto:[email protected]> >> > <mailto:[email protected] >> > <mailto:[email protected]>>> wrote: >> > >> > ps. The definite list of keywords is in Dancer2::Core::DSL. >> > >> > >> > On 21/12/20 5:14 pm, Gabor Szabo wrote: >> >> >> >> For example looking for the full list of words in the DSL: >> >> I clicked on both links saying DSL, neither of them had the list, nor >> >>a link to the manual >> >> where I findall found it: >> >> >> >>https://metacpan.org/pod/distribution/Dancer2/lib/Dancer2/Manual.pod#DSL-KEYWORDS >> <https://metacpan.org/pod/distribution/Dancer2/lib/Dancer2/Manual.pod#DSL-KEYWORDS> >> >> >> >><https://metacpan.org/pod/distribution/Dancer2/lib/Dancer2/Manual.pod#DSL-KEYWORDS >> <https://metacpan.org/pod/distribution/Dancer2/lib/Dancer2/Manual.pod#DSL-KEYWORDS>> >> >> >> >> >> > >> > >> > >> > _______________________________________________ >> > dancer-users mailing list >> > [email protected] >> ><mailto:[email protected]> >> > https://lists.preshweb.co.uk/mailman/listinfo/dancer-users >> ><https://lists.preshweb.co.uk/mailman/listinfo/dancer-users> >> > >> >> >> -- >> Ecommerce and Linux consulting + Perl and web application programming. >> Debian and Sympa administration. Provisioning with Ansible. >> >> >> _______________________________________________ >> dancer-users mailing list >> [email protected] <mailto:[email protected]> >> https://lists.preshweb.co.uk/mailman/listinfo/dancer-users >> <https://lists.preshweb.co.uk/mailman/listinfo/dancer-users> >> >> >> *Attachments:* >> >> * OpenPGP_signature > > -- > Jason A. Crome / CromeDome > CPAN: https://metacpan.org/author/CROMEDOME > <https://metacpan.org/author/CROMEDOME> > GitHub: https://github.com/cromedome <https://github.com/cromedome> > Twitter: https://twitter.com/cromedome <https://twitter.com/cromedome> > Blog: https://cromedome.net <https://cromedome.net> > > > _______________________________________________ > dancer-users mailing list > [email protected] > https://lists.preshweb.co.uk/mailman/listinfo/dancer-users > -- Ecommerce and Linux consulting + Perl and web application programming. Debian and Sympa administration. Provisioning with Ansible.
OpenPGP_signature
Description: OpenPGP digital signature
_______________________________________________ dancer-users mailing list [email protected] https://lists.preshweb.co.uk/mailman/listinfo/dancer-users
