Documentation / code comments are currently not represented in Boo's AST; this feature request is for Documentation AST nodes.
Right now comments like #TODO, #HACK, /* this block of code is dangerous because ... ... .... */ are currently lost when the parser generates Boo's AST.
This is a loss of very useful information that could be provided to the user via IDE integration or for other applications doing code introspection on Boo's AST.
Wouldn't it be nice to click a button in your favorite IDE and get a list of all comments and their current locations in source code? Documentation AST would help in making that a reality without having to write a mangled comment parser.
It is also a step in the direction of being able to recreate source code from Boo's AST.
What, why are you still reading? Are you not convinced yet?!