> Hm looking at the last example in that page - does it always prepand each unittest block with "Examples:" ?

Yeah, I'm on the fence about that one too. I think I implemented it this way since it was the simplest way to do it. But I could reimplement this so it outputs a single `Example` if there's only one ddoc'ed unittest, or a single `Examples` title if there are multiple ddoc'ed unittests..

> Truth be told my second main problem with this feature is that it makes you put unittest right after the function being tested

This is [Issue 9730](http://d.puremagic.com/issues/show_bug.cgi?id=9730), we'll eventually figure something out. It would be a win for cases where someone implements unittests in a different location, or even a different module (the latter is useful when you want to verify that a function propery works with private or inaccessible symbols).