search

w3c / html-aria

ARIA in HTML
https://w3c.github.io/html-aria/
Other
181 stars 48 forks source link

References to "web developer" #271

Closed LJWatson closed 3 years ago

LJWatson commented 3 years ago

The references to "web developers" throughout seems to exclude DPub content authors, though the spec includes the DPub ARIA roles.

scottaohara commented 3 years ago

Yes. seems to me this should just be changed to "authors"

LJWatson commented 3 years ago

That is the usual W3C parlance, yes.

stevefaulkner commented 3 years ago

This term was used deliberately as I know of no one that would consider themselves as "authors" except people who write books. Can i suggest we drop "web" and just use "developers"?

scottaohara commented 3 years ago

@LJWatson, @stevefaulkner I have removed instances of "web developer" and replaced with "developer" in this commit.

The spec now uses both the terms "developer" and "author". we can either leave this as is, or we can change them all to one or the other.

marcoscaceres commented 3 years ago

Developers is more "in vogue"... and thus, I'd urge us to follow Madonna.

LJWatson commented 3 years ago

This term was used deliberately as I know of no one that would consider themselves as "authors" except people who write books.

Not everyone considers themselves a developer either.

The term "author" is used throughout W3C specifications as a simple way of referring to someone who authors a document, be it with words or code, so I do not recommend changing it.

myfonj commented 3 years ago

Unsolicited anecdotal evidence from stranger: "Introduction" chapter of HTML spec contains 62 occurrences of string author (inc. authoring), 4 occurrences of string developer. There is even charming phrase "novice author":

[...] authors are encouraged to consult tutorials and guides. Some of the examples included in this specification might also be of use, but the novice author is cautioned that [...]

I understand that it might feel strange at first to refer to self as "author" while producing or enriching markup of content authored by different person, but I really doubt that people coming to ARIA specs will be exposed to this particular meaning for the first time and that they might get confused.