ANN: hCard Tutorial

Hi Folks,

I have created a tutorial on how to markup (X)HTML documents
using the
hCard properties:

http://
www.xfront.com/microformats/hCard.html

Comments welcome. 

/Roger

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

On 12/4/06 4:06 PM, "Costello, Roger L."
<costellomitre.org> wrote:

> Hi Folks,
> 
> I have created a tutorial on how to markup (X)HTML
documents using the
> hCard properties:
> 
> http://
www.xfront.com/microformats/hCard.html
> 
> Comments welcome.

Hi Roger,

This is a nice step by step tutorial presentation.

One critique is that the first couple of examples with Dr.
John Q. Public
are invalid hCard because you cannot *only* use
"fn" with a formatted name
that is more than two words - you *must* also use
"n" and its subproperties.

See: http://microformats.org/wiki/hcard#Implied_.22n.2
2_Optimization

Consider changing your first and second examples to only
state "John Public"
and therefore able to use the implied N optimization rule. 
This way you
introduce people to the common easy case first, and then
show the more
detailed example with "n" and subproperties later.

Thanks,

Tantek

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

In message <B8415163A689094689542C617ECA0366013BE564IMCSRV5.MITRE.ORG>,
"Costello, Roger L." <costellomitre.org> writes

>I have created a tutorial on how to markup (X)HTML
documents using the
>hCard properties:
>
>http://
www.xfront.com/microformats/hCard.html
>
>Comments welcome.

Nice work, but in maximised Firefox, at 1280x1024, I find
the red
examples too small and closely bunched to read. Would you
like a
screenshot?

-- 
Andy Mabbett
                Say "NO!" to compulsory ID Cards: 
<http://www.no2id.net/>

                Free Our Data:  <http://www.freeourd
ata.org.uk>
_______________________________________________
microformats-discuss mailing list
microformats-discussmicroformats.org
http://microformats.org/mailman/listinfo/microforma
ts-discuss

In message <B8415163A689094689542C617ECA0366013BE564IMCSRV5.MITRE.ORG>,
"Costello, Roger L." <costellomitre.org> writes

>I have created a tutorial on how to markup (X)HTML
documents using the
>hCard properties:
>
>http://
www.xfront.com/microformats/hCard.html

This isn't in any way a criticism of your tutorial, but,
further to
recent discussion, it's worth noting that not only does the
tutorial
include no mention of a profile URI, but also that, until
now, nobody
had even thought that worthy of comment.

-- 
Andy Mabbett
            *  Say "NO!" to compulsory ID Cards: 
<http://www.no2id.net/>
            *  Free Our Data:  <http://www.freeourd
ata.org.uk>
            *  Are you using Microformats, yet: <http://microformats.org/
> ?
_______________________________________________
microformats-discuss mailing list
microformats-discussmicroformats.org
http://microformats.org/mailman/listinfo/microforma
ts-discuss

On Dec 18, 2006, at 4:50 PM, Andy Mabbett wrote:

> This isn't in any way a criticism of your tutorial,
but, further to
> recent discussion, it's worth noting that not only does
the tutorial
> include no mention of a profile URI, but also that,
until now, nobody
> had even thought that worthy of comment.

Searching the archives, I see a discussion of profile URIs
as far  
back as July of 2005, less than a month after this list
began:

http://microformats.org/discuss/mail/microfo
rmats-discuss/2005-July/ 
000149.html

So it's not a new idea.  It just hasn't gained much adoption
yet.

Peace,
Scott

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

On 12/5/06, Costello, Roger L. <costellomitre.org> wrote:
> I have created a tutorial on how to markup (X)HTML
documents using the
> hCard properties:

Very nice Roger.

Where you say "Why isn't it hCard? Apparently there are
some
historical reasons for it, but I do not know the
reasons." in slide 3,
the simple answer is that in vCard, the root property is
VCARD, as in:

BEGIN:VCARD
[ ... stuff here ... ]
END:VCARD

As far as I know, that's the reason.

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

Hey Andy,

Actually, I do talk about the hCard profile.  See slide 10:

h
ttp://www.xfront.com/microformats/hCard_part5.html

/Roger

-----Original Message-----
From: microformats-discuss-bouncesmicroformats.org
[mailto:microformats-discuss-bouncesmicroformats.org] On Behalf
Of
Andy Mabbett
Sent: Monday, December 18, 2006 5:51 PM
To: Microformats Discuss
Subject: Re: [uf-discuss] ANN: hCard Tutorial

In message
<B8415163A689094689542C617ECA0366013BE564IMCSRV5.MITRE.ORG>,
"Costello, Roger L." <costellomitre.org> writes

>I have created a tutorial on how to markup (X)HTML
documents using the
>hCard properties:
>
>http://
www.xfront.com/microformats/hCard.html

This isn't in any way a criticism of your tutorial, but,
further to
recent discussion, it's worth noting that not only does the
tutorial
include no mention of a profile URI, but also that, until
now, nobody
had even thought that worthy of comment.

-- 
Andy Mabbett
            *  Say "NO!" to compulsory ID Cards:
<http://www.no2id.net/>
            *  Free Our Data:  <http://www.freeourd
ata.org.uk>
            *  Are you using Microformats, yet:
<http://microformats.org/
> ?
_______________________________________________
microformats-discuss mailing list
microformats-discussmicroformats.org
http://microformats.org/mailman/listinfo/microforma
ts-discuss

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

On 12/19/06, Ciaran McNulty <mailciaranmcnulty.com>
wrote:
> Where you say "Why isn't it hCard? Apparently
there are some
> historical reasons for it, but I do not know the
reasons." in slide 3,
> the simple answer is that in vCard, the root property
is VCARD, as in:

I should have added 'so because hCard gets all its
fieldnames from
vCard, this is carried across'.

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

Am Montag, 18. Dezember 2006 23:50 schrieb Andy Mabbett:

> This isn't in any way a criticism of your tutorial,
but, further to
> recent discussion, it's worth noting that not only does
the tutorial
> include no mention of a profile URI, but also that,
until now, nobody
> had even thought that worthy of comment.

The main intention of a tutorial is to _use_ it to learn
something, not to 
comment on it. Besides that the writer of such a tutorial
generally learns 
most of it.

If the tutorial is correct and maybe useful, the correct way
to handle that 
would be to include a link in the wiki. Simply defining any
tutorial not from 
one of the famous elite microformats authors as unnecessary
nonsense is the 
fastest way to make microformats a secret elite format,
unknown to and unused 
by the rest of the world.


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

In message <200612201009.27224.siegfriedrorkvell.de>, Siegfried Gipp
<siegfriedrorkvell.de> writes

>> This isn't in any way a criticism of your tutorial,
but, further to
>> recent discussion, it's worth noting that not only
does the tutorial
>> include no mention of a profile URI, but also that,
until now, nobody
>> had even thought that worthy of comment.
>
>The main intention of a tutorial is to _use_ it to learn
something, not
>to comment on it.

Perhaps you missed the original announcement:

        In message
        <B8415163A689094689542C617ECA0366013BE564IMCSRV5.MITRE.ORG>,
        "Costello, Roger L." <costellomitre.org> writes

        >Comments welcome.

>Simply defining any tutorial not from one of the famous
elite
>microformats authors as unnecessary nonsense is the
fastest way to make
>microformats a secret elite format, unknown to and
unused by the rest
>of the world.

and who did that?

-- 
Andy Mabbett
            *  Say "NO!" to compulsory ID Cards: 
<http://www.no2id.net/>
            *  Free Our Data:  <http://www.freeourd
ata.org.uk>
            *  Are you using Microformats, yet: <http://microformats.org/
> ?
_______________________________________________
microformats-discuss mailing list
microformats-discussmicroformats.org
http://microformats.org/mailman/listinfo/microforma
ts-discuss