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. 

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>  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@strategicdata.com.au
> <mailto:russell.jenkins@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>
>>
>>



> _______________________________________________
> dancer-users mailing list
dancer-users@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.


_______________________________________________
dancer-users mailing list
dancer-users@lists.preshweb.co.uk
https://lists.preshweb.co.uk/mailman/listinfo/dancer-users


Attachments:

--
Jason A. Crome / CromeDome
CPAN: https://metacpan.org/author/CROMEDOME
GitHub: https://github.com/cromedome
Twitter: https://twitter.com/cromedome
Blog: https://cromedome.net