add comments for topology usage