NAME

$pkg - (description goes here)

SYNOPSIS

use $pkg;

DESCRIPTION

(description goes here)

AUTHOR

Nigel Horne <njh\@nigelhorne.com>

LICENSE

Copyright (C) 2026 Nigel Horne. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

NAME

App::Project::Doctor::Check::Pod - Check POD presence and validity in all modules

DESCRIPTION

Uses Pod::Checker to validate every .pm under lib/. Modules with no POD at all get a fixable finding that appends a minimal skeleton.

MESSAGES

Code | Trigger                  | Resolution
-----|--------------------------|-----------------------------------------------
P001 | No POD in a .pm file     | Fix appends a skeleton; fill in by hand
P002 | Pod::Checker error       | Correct the malformed POD

FORMAL SPECIFICATION

check : Context -> [Finding]
check ctx ==
  concat [ check_one m | m <- lib_modules ctx ]
  where check_one m ==
          (if no_pod m then [error+fix] else [])
          ++ pod_errors m

AUTHOR

Nigel Horne <njh@nigelhorne.com>

LICENSE

Copyright (C) 2026 Nigel Horne. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.