こういうのってどう？

きれいではないけど、PHPでドキュメントを書くときにこうするのは変かな？
sample.php

<?php
（何かしらソースを書く）

return;
?>
==BEGIN==
ドキュメントを書く
==END==

「return」以下は実行されないので何を書いてもよい。
さらにの外はHTMLとみなされるので、何を書いてもよい。
あとはパーサがあればよいのよね。「return」が気持ち悪いのでダメかな。