Yep, I do think they should be removed. No one reads it and its duplicated in README.md. Once the forge can process these automatically and generate class and defined resource docs this would be the way to go, but now, its just another place for things to go out of sync :-).