Documenting assumptions and caveats

This issue is to ensure that assumptions and caveats are clearly documented for users. Here is an example of the type of information We'll want to put these details in with the documentation on the calculations and/or functions.