W3C

W3C mobileOK Scheme 1.0

Editor's Editors' Draft 17 October 2008 10 June 2009

This version:
http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20081017 http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20090610
Latest Editor's version:
http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/latest
Previous version: versions:
( diff ) http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20090609
( diff ) http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20081114
( diff ) http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20081113
( diff ) http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20081112
( diff ) http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20081111
( diff ) http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20081110
( diff ) http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20081106
( diff ) http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20081017
( diff ) http://www.w3.org/2005/MWI/BPWG/Group/Drafts/mobileOK-Trustmark/20080806
Editors:
Jo Rabin, dotMobi
Phil Archer, Family Online Safety Institute of Informatics & Telecommunications (IIT), NCSR "Demokritos" (formerly with FOSI)

Abstract

The mobileOK scheme allows content providers to promote their content as being suitable for use on very basic mobile devices. This document provides an overview of the scheme and references the documentation that composes it.

Status of this Document

This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at http://www.w3.org/TR/.

This is an Editor's Draft of the W3C mobileOK Scheme. It follows a period of evolution during which the Working Group considered defining two levels of mobileOK conformance, each with its own set of tests. mobileOK is presented here as a simplified and unified scheme in which the relationship with the Best Practices document, the Basic Tests and the Checker is made explicit. It represents substantial change from the previously published version.

The Working Group expects to publish this as a Note and not as a Recommendation track document.

Publication as a Editor's Draft does not imply endorsement by the Best Practices Working Group or by W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.

This document has been produced by the Mobile Web Best Practices Working Group as part of the Mobile Web Initiative . Please send comments on this document to the working group's public email list public-bpwg-comments@w3.org , a publicly archived mailing list .

This document was produced by a group operating under the 5 February 2004 W3C Patent Policy . W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy .

Table of Contents


Introduction

1. The mobileOK Scheme

mobileOK is designed to improve the Web experience for users of mobile devices by rewarding content providers that adhere to good practice when delivering content to mobile devices. them.

mobileOK says nothing about what may be delivered to non-mobile devices; furthermore, mobileOK does not imply endorsement or suitability of content. For example, it must not be assumed that mobileOK content is of higher informational value, is more reliable, more trustworthy, is or it is not appropriate for children etc.

The mobileOK Claim mobileOK provides a mechanism to represent, in a machine-processable way, a claim that content can be requested from URI so that the response conforms to mobileOK Basic 1.0 Tests [ mobileOK ] and hence will provide at least a functional user experience on mobile devices. Specifically, a claim of mobileOK may only be made of a URI that when dereferenced in the manner described in [ mobileOK ] yields a response that passes all the tests contained in mobileOK Basic Tests. Such a claim says nothing about other experiences that may be provided at the same URI, when dereferenced in a different way (e.g. with different User-Agent and Accept HTTP headers). A mobileOK claim may be made by the content provider themselves or any third party. The mobileOK Trustmark When making a mobileOK claim, content providers may add a visual indication, intended for humans, to communicate the presence of a claim. The trustmark is a W3C copyright image which may only be used in accordance with the W3C mobileOK license [ LICENCE ].

1.1 mobileOK Basic Tests 1.0

mobileOK Basic Tests 1.0 [ mobileOK ] specifies a number of tests that HTTP responses must pass when a URI is requested with a specific set of HTTP headers in the HTTP request. The tests are designed to be machine processable and to provide confidence that content will display well on very basic mobile devices.

1.2 Mobile Web Best Practices 1.0

mobileOK Basic Tests 1.0 is itself based on Mobile Web Best Practices 1.0 [ BP ], which provides a set of sixty guidelines for making content work well across a wide variety of mobile devices.

1.3 The Default Delivery Context

The HTTP Request headers used in mobileOK Basic Tests 1.0 identify a hypothetical user agent called the "Default Delivery Context" (DDC). The values of the key properties of the DDC (screen with, width, formats supported and other basic characteristics) are set at the minimum possible, while still supporting a Web experience.

The DDC is thus not a target to aspire to, it merely sets a base line below which content providers do not need to provide their content. It is expected that content providers, as well as targetting DDC level devices devices, will wish also to provide non-mobileOK experiences for more advanced devices. Mobile Web Best Practices 1.0 mobileOK Basic Tests is itself based on Mobile Web Best Practices [ BP ], which provides a set of sixty guidelines for making content work well across a wide variety of mobile devices.

1.4 mobileOK Checker

A software package known as called the mobileOK Checker [ CHECK ], has been developed by the Best Practices Working Group to provide automated checking of conformance. This The package is used to provide in Java, and is open source. It is available under a W3C License .

W3C has created a Web interface as part of the W3C Validator . The package is in Java, , which uses this package. Other Web based checkers, by dotMobi (see ready.mobi ) and is open source. It is available under CTIC (see TAWDIS ) have also been created that adhere to the W3C License [@@link]. mobileOK Basic Tests 1.0 [ mobileOK ].

2.

2 Claiming mobileOK Conformance

Content Providers may wish to identify that their content is mobileOK conformant. This means that it can be requested so that the response conforms to mobileOK Basic Tests 1.0 [ mobileOK ] and hence will provide at least a functional user experience on mobile devices. A claim of mobileOK conformance is may only be made in of a machine-readable way, by associating metadata with URI that when dereferenced in the resource manner described in [ mobileOK ] yields a response that passes all the tests contained in mobileOK Basic Tests 1.0. Such a claim relates to. A visual, i.e. human perceivable, trustmark says nothing about other experiences that may be used to indicate provided at the same URI, when dereferenced in a different way (e.g. with different User-Agent and Accept HTTP headers).

2.1 The mobileOK Icon

W3C provides a mobileOK icon that represents a URI claim that the content on which the icon is capable found is mobileOK conformant as described above.

The icon is most appropriately used on desktop representations of yielding a resource for which a mobileOK representation is also available. In such a situation it acts as a signal to a desktop user that the content may or service they are using is also be provided (See 3. Use available on a mobile device. Display of the mobileOK Trustmark). icon is usually inappropriate on a mobile device since whether the content is usable on their device or not will be fully apparent without it.

Conformance claims may either When displaying a mobileOK icon, the image should be embedded served from the same server as the resource, not from the W3C site. Note that the image is provided in PNG format which is a resource (See RDFa further reason why it is not suitable for use on mobileOK representations of pages, though it may be used on other representations.

The icon is issued under W3C copyright and may only be used in accordance with the W3C mobileOK license [ LICENSE ) or ], the key feature being that it may only be made used in a separate document formatted representations of resources that, when dereferenced in RDF or POWDER . accordance with the mobileOK Basic Tests 1.0, pass those tests.

2.2 Machine Readable Identification

Claims that are not embedded in a resource To enhance discoverability of mobileOK content, providers may wish to identify their material as being mobileOK using POWDER (see Claiming mobileOK Conformance Using POWDER ). Content should then be linked to from the resource a claim as described in 2.4 2.2.3 Linking Resources to Claims .

2.1 mobileOK in RDF To support claims of conformance with mobileOK, a one-class RDF vocabulary is defined. The namespace is http://www.w3.org/2008/06/mobileOK# and the class has the name Conformant . The following RDF triple asserts that the URI http://example.com is mobileOK conformant: < http://example.com > rdf:type < http://www.w3.org/2008/06/mobileOK#> 2.2

2.2.1 Claiming mobileOK Conformance using Using POWDER

The Protocol for Web Description Resources [ POWDER ] provides a means through which a claim of mobileOK conformance may be made about many resources at once, such as all those available from a Web site. Importantly, POWDER also provides a means of identifying the person, organization or entity that made the claim. These two features make POWDER's Description Resources an ideal transport mechanism for mobileOK conformance claims (mobileOK was a key use case for POWDER).

In the following (fictitious) example, on 25th June 2008, 2008 (line 5), the organization described at http://www.example.com/company.rdf#me (line 4) claimed that all the resources available from example.com (lines 9-11) were mobileOK. mobileOK (line 13). This makes use of a one-class RDF vocabulary with namespace http://www.w3.org/2008/06/mobileOK# and class name Conformant .

1  <?xml version="1.0"?>
2  <powder xmlns="http://www.w3.org/2007/05/powder#">
3    <attribution>
4      <issuedby src="http://www.example.com/company.rdf#me" />
5      <issued>2008-06-25T00:00:00</issued>
6      <supportedby src="http://validator.w3.org/mobile/" />

6      <supportedby src="http://example.net/checker/" />

7    </attribution>
8    <dr>
9      <iriset>
10       <includehosts>example.com</includehosts>
11     </iriset>
12     <descriptorset>
13       <typeof src="http://www.w3.org/2008/06/mobileOK#Conformant" />
14       <displaytext>The example.com webiste conforms to mobileOK</displaytext>
15       <displayicon src="http://www.w3.org/ICONS/mobileOK.png" />

15       <displayicon src="http://www.example.com/images/mobileOK.png" />

16     </descriptorset>
17   </dr>
18
</powder>

http://www.example.com/company.rdf#me (line 4) should lead to an RDF resource that describes the entity (either the foaf:Agent or dcterms:Agent ) that provided the Description Resource. It is open to that organization to provide authentication methods to support its claim of mobileOK conformance. Note also in line 6 that POWDER's supportedby element has been used to refer to the mobileOK Checker, http://example.net/checker/, the implication being that the content of the described Web site has been tested using the Checker. that checker. Lines 14 and 15 provide textual and graphical data that user agents may display to end users.

2.3 Claiming mobileOK Conformance using RDFa RDF Annotation [ RDFa ] can be used to embed a claim of mobileOK conformance directly in an XHTML document as shown in the following example - however, note that RDFa should not be used in document instances that are themselves intended to be mobileOK as RDFa is not permitted in mobileOK documents. 1 <html 2 xmlns="http://www.w3.org/1999/xhtml" version="XHTML+RDFa 1.0" 3 xmlns:mok="http://www.w3.org/2008/06/mobileOK#" > 4 <head typeof="mok:Conformant"> 5 <title>Document Title </title> 6 </head> The version attribute on the html element is optional but is a clear signal to a processor that the document contains RDF annotations. The typeof attribute on the head is a shorthand way used in RDFa to assert the rdf:type relationship so that an RDFa-aware user agent will extract the RDF triple: < > rdf:type < http://www.w3.org/2008/06/mobileOK#> i.e. that the current document is an instance of the class of resources that conform to mobileOK. Note that using RDFa to claim conformance with mobileOK implies that the entity making the claim is the content creator. Furthermore, user agents are given no clue as to how they may authenticate the claim. Therefore this method should not be seen as an equivalent method to using POWDER. 2.4

2.2.2 Linking Resources to Claims using the HTML link Element

All mobileOK resources are HTML. In the following example a powder document is linked using the link element. element (line 3). The value of the rel attribute, "powder" "describedby" is namespaced by the profile attribute of the head element. element (line 2) in versions of HTML that support it.

<html xmlns="http://www.w3.org/1999/xhtml"> <head profile="http://www.w3.org/2007/11/powder-profile"> <link rel="powder" href="powder.xml" type="application/xml"/> <title>Welcome to example.com </title> </head> <body> <p>Today's content is ....</p> </body> </html>
1  <html xmlns="http://www.w3.org/1999/xhtml">
2     <head profile="http://www.w3.org/2007/11/powder-profile">
3        <link rel="describedby" href="powder.xml" type="text/powder+xml"/>
4        <title>Welcome to example.com </title>
5     </head>
6     <body>
7        <p>Today's content is ....</p>
8     </body>
9  </html>

3. Using

2.2.3 Linking Resources to Claims using the MobileOK Trustmark HTTP link Header

The W3C provides a logo or trustmark that In many application environments it can also be used appropriate to indicate that a mobileOK version of the resource that carries it is available from the same URI that the resource that carries the trustmark was retrieved. Use of the trustmark use HTTP Link [ HTTP Link ] headers. The following header is governed by semantically equivalent to the license agreement [@@@]. HTML link header above.

Link:
<powder.xml>;
rel="describedby"
type="text/powder+xml";

2.2.4 Other Forms of Claim

The trustmark is most appropriately used on desktop representations Other machine readable means of making a resource for which a claim of mobileOK representation is also conformance are available. In such a situation it acts as a signal to a desktop user For example the following RDF triple asserts that the content or service they are using URI http://example.com is also available on a mobile device. Display of the mobileOK trustmark is usually inappropriate on a mobile device since whether the content is usable on their device or not will be fully apparent without it. conformant:

When displaying < http://example.com > rdf:type < http://www.w3.org/2008/06/mobileOK#conformant>

Other forms of expressing a mobileOK trustmark, the image should be served from the same server as the resourece, but claim may become available in any case not from the W3C site. future.

4. 3. Acknowledgements

The editors would like to thank members of the BPWG for contributions of various kinds.

Previous Editors:
Sean Owen, Google
Charles McCathieNevile, Opera Software
Significant written contributions: Dominique Hazaël-Massieux, W3C

5. 4. References

BP
Mobile Web Best Practices 1.0 . Jo Rabin, Charles McCathieNevile, W3C Recommendation 29 July 2008
BASIC
W3C mobileOK Basic Tests 1.0 . Sean Owen, Jo Rabin. W3C Working Draft 10 June Recommendation 8 December 2008
CHECK
W3C mobileOK Checker . Dominique Hazaël-Massieux, François Daoust BPWG Checker Task Force
LICENSE
W3C mobileOK License (draft, member only link) .
POWDER
Protocol for Web Description Resources (POWDER): Description Resources . Phil Archer, Kevin Smith, Andrea Perego. W3C Working Draft 8 August 2008 Proposed Recommendation, 4 June 2009
RDFa
RDFa in XHTML: Syntax and Processing Web Linking Ben Adida, Mark Birbeck, Shane McCarron, Steven Pemberton. W3C Candidate Recommendation 20 June 2008 Nottingham, Internet Draft, 17 April 2009 (expires 19 October 2009, expected to advance to RFC status)