Re: Country, external ennumeration?

Even if 'canceled' has similar meanings across different domains, it's
still difficult to document exactly what cases the value should be used in,
when all use cases are blended together into one global namespace.

Moreover, that's just one example. To me it seems self-evident that putting
all enum values in a global namespace will fail to scale as the schema
grows. Look at the enum values defined in http://schema.org/PhysicalExam,
for another example. All those terms (Head, Eye, Appearance, etc.) are now
unusable in schema.org vocabulary in any other context than types of
physical exam. Wouldn't a value of schema.org/PhysicalExam#Appearance make
more sense?

Thanks,
Justin


On Thu, Oct 31, 2013 at 12:26 PM, Thad Guidry <thadguidry@gmail.com> wrote:

> In this case, the notion of "canceled" is a fairly concrete meaning
> semantically across almost all domains, I would say.  So it should be
> global in aspect for anyone wanting to use it.
>
> Having said that.. Canceled is action specific.  And we already have the
> idea of it ... here: http://schema.org/CancelAction
>
> See the full hierarchy as well, thus far :
> http://schema.org/docs/full.html
>
>
>
> On Thu, Oct 31, 2013 at 10:35 AM, Justin Boyan <jaboyan@google.com> wrote:
>
>> I agree that the use of schema.org/Enumeration, vs. external
>> enumerations, is confusing.
>>
>> I would like to raise a related proposal, to make it easier to define and
>> use internal Enumerations.  Currently all enumeration values are defined in
>> the global top-level schema.org namespace.  For example, each value of
>> the MedicalSpecialty <http://schema.org/MedicalSpecialty> enumeration,
>> such as http://schema.org/Nursing, is a top-level entity.  It therefore
>> conflicts with any other proposed enumerations that might want to use
>> Nursing as a value, or for that matter any proposed type named
>> schema.org/Nursing.   This isn't just a theoretical concern - there are
>> currently at least three enumeration proposals (OrderStatus, ActionStatus,
>> EventStatus) that all want to use "Canceled" as an enum value, but those
>> notions of canceled can't be defined and documented separately given the
>> global namespace.
>>
>> Proposal: can we define a local namespace for internal enumerations?  How
>> about a fragment naming scheme, like
>> http://schema.org/OrderStatus#Canceled  and
>> http://schema.org/EventStatus#Canceled ? That scheme would also improve
>> our documentation, keeping all the enum values and their descriptions
>> organized on a single web page corresponding to their type. In markup, we
>> could arrange to accept "Canceled" or "#Canceled" as shorthand entries for
>> the enum value.
>>
>> Justin
>>
>>
>>
>> On Thu, Oct 24, 2013 at 3:27 PM, Willem-Siebe Spoelstra <
>> wsspoelstra@gmail.com> wrote:
>>
>>> Hi, on this schema.org blogpost<http://blog.schema.org/2012/05/schemaorg-markup-for-external-lists.html> I
>>> read the follwing:
>>>
>>> Each schema.org type (such as Person <http://schema.org/Person>,
>>>> PostalAddress <http://schema.org/PostalAddress>) is associated with a
>>>> set of properties, such as
>>>> "nationality", "addressCountry". In turn, each property has one or more
>>>> expected types; in this case, both the "nationality" of a Person, and the
>>>> "addressCountry" of a PostalAddress <http://schema.org/PostalAddress> expect
>>>> to have a Country <http://schema.org/Country>value
>>>
>>>
>>> So I took a look at the example in the same blogpost, and the specify
>>> the country like this:
>>>
>>>
>>>
>>>
>>> <link itemprop="nationality" href="http://en.wikipedia.org/wiki/United_States"/>
>>>
>>>
>>>
>>>
>>>
>>>
>>>
>>> When I read this blogpost <http://blog.schema.org/2012/11/good-relations-and-schemaorg.html> about Schema.org and Goodrelations, this is explained like:
>>>
>>>
>>>
>>>
>>>
>>>
>>>
>>>   general approach for referencing 'external enumerations<http://blog.schema.org/2012/05/schemaorg-markup-for-external-lists.html>
>>>> '.
>>>
>>>
>>> However, when I look at the itemtype 'Country'<http://schema.org/Country>,
>>> which is the expected type for the item properties 'nationality' and
>>> 'addressCountry', I don't see anything explaining the above...
>>>
>>> It only tells me:
>>>
>>> A country
>>>
>>>
>>> I do see a list of properties, but the best option there is to use
>>> 'name' from 'Thing', which in that case should be 'text' just putting down
>>> the name of the country. Nobody is explaining me that I have to link to,
>>> for example, WikiPedia as explained in the blogpost.
>>>
>>> So, what's the best practise here?
>>>
>>> And why is 'Country' not a more specif type of Enumeration,
>>> http://schema.org/Enumeration,
>>>
>>> Kind regards,
>>>
>>> Willem
>>>
>>>
>>
>
>
> --
> -Thad
> +ThadGuidry <https://www.google.com/+ThadGuidry>
> Thad on LinkedIn <http://www.linkedin.com/in/thadguidry/>
>