Project

General

Profile

coordination #50510

Updated by szarate almost 5 years ago

Each function in the lib/ folder needs to be documented with POD 

 ## AC 

 - **AC1:** Most of the functions are documented 
 - **AC2:** Undocumented functions are marked as undocumented 
 - **AC3:** each function in lib/ has a POD block that explains it 

 ## How to write the documentatin 

 - At level one we have the name of the module and a short synopsis with brief description 
 - At level two we have the names of each functions before the functions 


 ```perl ` 
 =head1 MY_MODULE 

 =head1 SYNOPSIS 

     use lib::my_module 

 This is a module that does foobar 

 =cut 

 use testapi 
 use stuff 
 use other_stuff 

 =head2 my_function 

 this is a function that does nothing because it's for documentation purposes 

 =cut 

 sub my_function {} 

 ``` ` 

Back