in reply to swat on CPAN

A suggestion would be to add some POD for this:

marto@shemp ~/code $ perldoc swat
perl5::swat(3)        User Contributed Perl Documentation       perl5:
+:swat(3)



SYNOPIS
       SWAT is Simple Web Application Test ( Tool )

       Follow https://github.com/melezhik/swat

AUTHOR
       Aleksei Melezhik - <email address redacted>



perl v5.14.2                      2015-07-17                    perl5:
+:swat(3)

[download]

A start would be to have the content of the README here. This will also show up on cpan when people browse your module, and will give a better idea of what to expect. There are lot's of good examples of this on cpan, e.g. WWW::Mechanize. Thanks.

Update: See also On The Naming of Modules, App seems like a good choice.

Replies are listed 'Best First'.
Re^2: swat on CPAN
by melezhik (Monk) on Jul 17, 2015 at 12:57 UTC
    yeah, I need markdown to pod parser for this. do not you know one? thanks for advice. Alexey
[reply]

      There is Markdown::Pod, but the one review of it claims that it (too) often creates invalid Pod. For the reverse, there is Pod::Markdown, which creates Markdown documents from Pod. So if you're not adverse to creating your documentation in Pod, you can generate Markdown from that.

[reply]
        Corion ! I like Pod::Markdown better! it generates quite fine markdown from my pod doc, thanks for advice.
[reply]

      Hi Alexey, I've not used any but Markdown::To::POD, among others. Perhaps someone else has a recommendation.

[reply]
        Thanks for ideas, I have tried markdown::pod it is quite ok, though sometimes breaks my original markdown , but I think I can work it out eventually
[reply]
[reply]

In Section Perl News