gossi/docspec — Issue #11: Better Qualified Name (QNAME)
Author: gossi
Created: 2012-01-07 16:31:08+00:00
State: open

The current spec draft defines QNAME for the following:

- STRUCT: namespace + config.namespacedelimiter + name
- FUNCTION: namespace + '#' + name
- METHOD: namespace + config.namespacedelimiter + STRUCT.name + '#' + name

Two things I'm not 100% lucky with:

1. The hash as delimiter: Often is that QNAME turns into uris that are also used in urls with html output and then the hash is a reserved keyword here. So it must be taken with care to use it for the good. Can some of the DocTools developers give good use cases?

2. More QNAMEs: I'd like to see at least, that params are expressed by a unique identifier. What else?