finalizing the documentation framework