search

w3c / WebID

https://www.w3.org/groups/cg/webid
MIT License
14 stars 7 forks source link

Add description for specification's intended audience #29

Closed csarven closed 7 months ago

csarven commented 8 months ago

Clarifying who this specification is for signals to the reader whether and what they might be able to get out of this specification. This text - which could be adapted as the spec progresses - can also serve as an editorial guide on expressing certain notions and structuring.

kidehen commented 8 months ago

The intended audience of a specification is crucial. This is a very important fix that the WebID Specification doc needs.

jacoscaz commented 8 months ago

/chair hat off

+1 from me as-is.

which could be adapted as the spec progresses

Absolutely, but this is a good starting point.

kidehen commented 8 months ago

@TallTed,

"name" rather than "denote" for consistency with the overarching theme of the spec.

webr3 commented 8 months ago

Why are there pull requests against the old ed spec?

The CG is focussed on creating new documents.

TallTed commented 7 months ago

Why are there pull requests against the old ed spec?

Because relatively few relatively small changes to the old Editors Draft are expected to result in a document which can garner consensus approval.

The CG is focussed on creating new documents.

Where does anything say that?

TallTed commented 7 months ago

@kidehen's later suggestion has been applied to my change request.

jacoscaz commented 7 months ago

/chair hat on

@csarven would you be ok with me forking this and rebasing on main to maintain your contribution?

EDIT: result would look like https://github.com/jacoscaz/WebID/tree/docs/audience

jacoscaz commented 7 months ago

Closing in favor of #56 .