simplify YAML markers
add warning
fix old links