Code review comment for lp://staging/~javier.collado/checkbox-core/shadowd-docstrings

To merge this branch, I moved the second paragraph of your docstring from the checkbox.shadowd package to the doc/shadow.txt file. Then I added the corresponding entry in the doc/index.txt file. The rest looks good, so merging!