[Koha-devel] Coding Guidelines: POD Documentation

[Nick Clemens]

Hello Koha developers,

At the last developers meeting there was some discussion about guidelines
for requiring POD during QA.

Our current guideline is here:
https://wiki.koha-community.org/wiki/Coding_Guidelines#PERL13:_POD

The discussion centered on a few questions:
1 - Should (basic) POD be required when making a small change to a module
that has no existing POD. The answer to this seemed to be generally yes,
and Barton volunteered to assist. Anyone else wanting to help add POD is
more than welcome to join him :-)

2 - Where should POD go? Inline or after __END__ Please offer your opinion
if you feel strongly.

As I am cutting it close to sending before the meeting I think we can push
off adding/updating the guideline until the February meeting.

Thanks!

Nick (kidclamp)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.koha-community.org/pipermail/koha-devel/attachments/20170111/340ecbe6/attachment.html>