Re: explainer

Thanks John
It looks good but they asked us to follow the template And remove some sections.
Could you take a look at the tags comments? We need to adress them as well as make a good document.



All the best

Lisa Seeman

LinkedIn, Twitter




---- On Tue, 14 Apr 2020 02:01:53 +0300 john.foliot@deque.com wrote ----


Hi Lisa, Sharon,


Spent some time today with the draft, and have made some at-times significant changes: https://github.com/w3c/personalization-semantics/wiki/restructure-of-the-explainer 


Essentially, I've moved the Use-cases / User-stories down further in the body of the document, and instead tried to bring the 'technologies'  up and forward to sooner in the document (a.k.a. "know your audience"). I've also applied some formatting, added hyperlinks where I thought appropriate, removed some duplicate content, added some illustrations, and have added some additional internal notes for further discussion.

Because I've been dragging my feet on this task, I am also sharing it to the entire TF for wider review/comment now. Bricks and bouquets as seen fit.

JF


On Mon, Apr 13, 2020 at 11:04 AM John Foliot <john.foliot@deque.com> wrote:

This has been on me for a while now - apologies for the tardiness.


I'll take a crack at this today/tomorrow and advise.


JF


On Mon, Apr 13, 2020 at 10:23 AM lisa.seeman <lisa.seeman@zoho.com> wrote:

Hi Sharron and John



Would either of you have time to edit the restructuring the explainer?

See https://github.com/w3c/personalization-semantics/wiki/restructure-of-the-explainer


The point is to respond to the TAGs comments at https://github.com/w3ctag/design-reviews/issues/476

So we need more examination of use cases and some other content removed. It is already in the Tag's template. (note the content in squire  brackets is from the template instruction)



Beyond normal editorial, we want to keep it short, so any content that does not explain what we are doing or meet the TAG's questions/template can be edited out. 


I can add screen shots and worked expample they requested (if that helps).

All the best

Lisa Seeman

LinkedIn, Twitter













--

​John Foliot | Principal Accessibility Strategist | W3C AC Representative
Deque Systems - Accessibility for Good
deque.com









--

​John Foliot | Principal Accessibility Strategist | W3C AC Representative
Deque Systems - Accessibility for Good
deque.com