[dancer-users] List of DSL keywords

[Stefan Hornburg (Racke)]

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 <russell.jenkins at strategicdata.com.au
>> <mailto:russell.jenkins at strategicdata.com.au>
>> > <mailto:russell.jenkins at strategicdata.com.au <mailto:russell.jenkins at strategicdata.com.au>>> 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
>> > dancer-users at lists.preshweb.co.uk <mailto:dancer-users at lists.preshweb.co.uk>
>> > 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
>> dancer-users at lists.preshweb.co.uk <mailto:dancer-users at lists.preshweb.co.uk>
>> 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
> dancer-users at lists.preshweb.co.uk
> 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.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: OpenPGP_signature
Type: application/pgp-signature
Size: 840 bytes
Desc: OpenPGP digital signature
URL: <http://lists.preshweb.co.uk/pipermail/dancer-users/attachments/20201222/25a713c9/attachment.sig>