Third option?: Need for plain-language intros for each microformat

Hi all,

On Sep 7, 2007, at 7:00 AM, Eric A. Meyer wrote:
>>> or 2) leave the specs  where they are and
create new -intro pages.
>>> I've seen [...] no one object to #2.
>>
>> Then you haven't been paying full attention.
>
>    For those of us who indeed haven't been paying full
attention to  
> this particular thread (guilty), a citation or three
regarding  
> objections to #2 would be greatly helpful.

3. Let me propose what may or may not be a third option:

a) Leave the specs where are.

b) Add a good solid introductory  paragraph at the top of
the spec.

c) Link from there to an in-depth "-intro" page

This may just be a variant of #2, but I think it addresses
Andy's  
objections.  If not, perhaps he would be kind enough to
summarize  
them again.

Thanks,
-- Ernie P.



_______________________________________________
microformats-discuss mailing list
microformats-discussmicroformats.org
http://microformats.org/mailman/listinfo/microforma
ts-discuss

On Fri, September 7, 2007 11:25 am, Ernest Prabhakar wrote:
> 3. Let me propose what may or may not be a third
option:
>
> a) Leave the specs where are.
> b) Add a good solid introductory paragraph at the top
of the spec.
> c) Link from there to an in-depth "-intro"
page

+1 from me.

Angus

_______________________________________________
microformats-discuss mailing list
microformats-discussmicroformats.org
http://microformats.org/mailman/listinfo/microforma
ts-discuss

On 9/7/07 8:25 AM, "Ernest Prabhakar"
<ernest.prabhakargmail.com> wrote:

> Hi all,
> 
> On Sep 7, 2007, at 7:00 AM, Eric A. Meyer wrote:
>>>> or 2) leave the specs  where they are and
create new -intro pages.
>>>> I've seen [...] no one object to #2.
>>> 
>>> Then you haven't been paying full attention.
>> 
>>    For those of us who indeed haven't been paying
full attention to
>> this particular thread (guilty), a citation or
three regarding
>> objections to #2 would be greatly helpful.
> 
> 3. Let me propose what may or may not be a third
option:
> 
> a) Leave the specs where are.
> 
> b) Add a good solid introductory  paragraph at the top
of the spec.
> 
> c) Link from there to an in-depth "-intro"
page
> 
> This may just be a variant of #2, but I think it
addresses Andy's
> objections.  If not, perhaps he would be kind enough to
summarize
> them again.

Ernie, I believe this is essentially what has been proposed
for #2, per:

<http://microformats.org/discuss/mail/
microformats-discuss/2007-August/01057
5.html>

"
* brief plain-language intro at the top (say for example,
something that a
non-technical person like a member of the general
media/press could read and
understand)
"

same as your b) AFAIK.

"
* followed by links to more plain-language resources
"

similar to your c), which I also agree with.

Thanks,

Tantek

_______________________________________________
microformats-discuss mailing list
microformats-discussmicroformats.org
http://microformats.org/mailman/listinfo/microforma
ts-discuss