[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/)