Ok, I would like to try and summarize what should be done for .dev files 1.) .dev files should not be used to describe individual functions. Instead, the .c file that contains the function should be used. 2.) .dev files should contain the sections as mentioned in PDD07. 3.) .dev files should mainly be used to describe a.) the general overview of the file in question (what it is for, where it fits in) b.) any algorithms that were chosen for use in that file along with a description of why.
So, my final question is: should .dev files be plain text or POD?