docs: comments for shards