Improve documentation with deprection tag and line-<p>