OK to change anchor names in the language specification?
Jakob Ovrum
jakobovrum at gmail.com
Sat Feb 15 02:47:12 PST 2014
Many sections on dlang.org have anchor names, allowing for direct
linking to a particular section. Some examples include:
http://dlang.org/function#interpretation
http://dlang.org/arrays#static-arrays
http://dlang.org/template#alias-template
http://dlang.org/template#function-templates
http://dlang.org/statement#foreach_with_ranges
http://dlang.org/expression#Expression
As pointed out by Kenji in this pull request[1], this is a mess
of hyphen vs underscore, singular vs plural and lowercase vs
PascalCase. These names are manually specified in the DDoc
document, not automatically generated.
The aforementioned pull request[1] would make these anchors
public, by making the section headers links to themselves.
The question is - do we unify their formatting before making them
public? This would break existing links, but these links were
nigh unobtainable in the first place.
If we do change the format, which style do we use? Do we use
different styles for different kinds of sections, or just one
throughout? Here is some data to help make a decision[2]. Sorry
if the quality of the data is poor.
[1] https://github.com/D-Programming-Language/dlang.org/pull/497
[2] http://pastebin.com/Z6S3z6cC
More information about the Digitalmars-d
mailing list