[PLT-415] Clean comments and add reference to the relevant documentation.