Hi Robert

> Thank you!  I should have examined this more thoroughly.  I used dox
> because I needed a macro to describe options.  But now I see that I
> can say \NewDocElement{Option}{option}, which is fine.

one of the reasons for upgrading doc after such a long time was to add 
the ability to document other kind of code beside macros/envs so it how 
essentially offers what dox offered in the past but with a somewhat 
different API and a bit more functionality.

the other reason for upgrading was to enable hyperref support out of the 
box, because this is also usually wanted/needed.
> 
> Something similar affects the colordoc package because it redefines
> doc's \macro@finish, which has been changed.
> 
> What should we do?  Will the LaTeX3 team contact the authors of these
> packages or should rather I do it myself?

If could would do that and talk to Didier and Federico, it would be very 
much appreciated ... we are  stretched a bit thin, but if you prefer 
I'll do it.

Might also be worth talking to Scott because his skeletons could then 
perhaps also see some update

best
frank
>