[Doc-SIG] XML Conversion Update

Guido van Rossum guido@CNRI.Reston.VA.US
Mon, 30 Aug 1999 11:40:39 -0400


> The idea is to use the hierarchical location of an information
> object in a document assembly to arrive at a meaninful and unique
> names e.g.:
> 
> 	Library_Reference-Python_Services-UserList.xml
> 	API-Abstract_Objects_Layer-Mapping_Protocol.xml
> 
> As well as acting as names for information object storage
> these are also names for xref purposes e.g.:
> 
> 	See <xref idref="API-Abstract_Objects_Layer-Mapping_Protocol">
> 	the mapping protocol</xref> for more information.

Without any context, this looks like a horrible idea in one detail:
the mixing of underscores and hyphens that you propose.  Anything, but 
not that!  Make it CamelCase if you have to:

    LibraryReference-PythonServices-UserList.xml
    API-AbstractObjectsLayer-MappingProtocol.xml

--Guido van Rossum (home page: http://www.python.org/~guido/)