update annotations block, add code example for doc blocks