This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 25073 - You should have skilled writer—who understand the needs of readers—write this stuff. For example, the Apple example does not correct express how a writer would approach the topic. While this my ap [...]
Summary: You should have skilled writer—who understand the needs of readers—write this...
Status: RESOLVED NEEDSINFO
Alias: None
Product: WHATWG
Classification: Unclassified
Component: HTML (show other bugs)
Version: unspecified
Hardware: Other other
: P3 normal
Target Milestone: Unsorted
Assignee: Ian 'Hixie' Hickson
QA Contact: contributor
URL: http://www.whatwg.org/specs/web-apps/...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-03-15 23:37 UTC by contributor
Modified: 2014-03-17 19:45 UTC (History)
2 users (show)

See Also:

Attachments

Description contributor 2014-03-15 23:37:04 UTC 
Specification: http://www.whatwg.org/specs/web-apps/current-work/multipage/sections.html
Multipage: http://www.whatwg.org/C#headings-and-sections
Complete: http://www.whatwg.org/c#headings-and-sections
Referrer: 

Comment:
You should have skilled writer—who understand the needs of readers—write
this stuff. For example, the Apple example does not correct express how a
writer would approach the topic. While this my appear as a trivial issue, it
really is not. Poor quality examples make the content difficult to understand.
Quit using "foo

Posted from: 99.165.49.224
User agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_2) AppleWebKit/537.74.9 (KHTML, like Gecko) Version/7.0.2 Safari/537.74.9
Comment 1 Ian 'Hixie' Hickson 2014-03-17 19:45:03 UTC 
Can you be more specific regarding your concern? What is the problem with the "Apple" example? Do you have any suggested examples we should use instead?

I'm sorry I'm not skilled enough to do this. If you have anyone who would be better at writing this spec than me, I'd love to work with them. We have lots of work that needs doing that isn't being done right now due to lack of people.