From: tzafrir <tzafrir@web>
Date: Sat, 7 Nov 2009 19:01:09 +0000 (-0500)
Subject: s/a name/id/ ?
X-Git-Tag: 3.20091113~40
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=73c3f0d7018041acac259eedf501dc6d9a52e1af;p=ikiwiki.git

s/a name/id/ ?
---

diff --git a/doc/ikiwiki/wikilink/discussion.mdwn b/doc/ikiwiki/wikilink/discussion.mdwn
index b146c9447..d6df4cbf6 100644
--- a/doc/ikiwiki/wikilink/discussion.mdwn
+++ b/doc/ikiwiki/wikilink/discussion.mdwn
@@ -43,6 +43,11 @@ BTW, ikiwiki doesn't displays the #foo anchor in the example
 
 >> Fixed that --[[Joey]]
 
+The 'name' attribute of the 'a' element is a depracated way to create a named anchor. The right way to do that is using the 'id' attribute of any element. This is because an anchor may refer to a complete element rather than some point in the page.
+
+Standard purity aside, if you define an anchor (using either 'a name' or 'id') to a single point in the document but refer to a complete section, the browser may just show that specific point at the bottom of the page rather than trying to show all the section.
+--[[tzafrir]]
+
 ---
 
 Considering a hierarchy like `foo/bar/bar`, I had the need to link from the