Analyze the following code snippet and write detailed documentation for it. Include a summary of what the function does, descriptions of the parameters, the return value, and inline comments explaining complex logic blocks. [Insert code here].