hAtom issues

(Difference between revisions)

Jump to: navigation, search
(Entry Summary (atom:summary))
Current revision (19:49, 25 August 2013) (view source)
m (Reverted edits by Gowrvw (Talk) to last version by Tantek)
 
(261 intermediate revisions not shown.)
Line 1: Line 1:
-
= Discussion Participants =
+
<entry-title> hAtom issues </entry-title>
 +
These are externally raised issues about [[hAtom]] with broadly varying degrees of merit. Thus some issues are REJECTED for a number of obvious reasons (but still documented here in case they are re-raised), and others contain longer discussions. Some issues may be ACCEPTED and perhaps cause changes or improved explanations in the spec.
-
== Editors ==
+
'''IMPORTANT''': Please read the [[hatom-faq|hAtom FAQ]] and the [[hatom-issues-resolved|hAtom resolved issues]] ''before'' giving any feedback or raising any issues as your feedback/issues may already be resolved/answered.
-
* [http://www.blogmatrix.com David Janes]
+
-
== Authors ==
+
Submitted issues may (and probably will) be edited and rewritten for better terseness, clarity, calmness, rationality, and as neutral a point of view as possible. Write your issues well. [http://tantek.com/ Tantek]
-
* [http://www.blogmatrix.com David Janes]
+
-
* [http://www.dannyayers.com Danny Ayers]
+
-
* [http://tantek.com/ Tantek Çelik]
+
-
* [http://www.opendarwin.org/~drernie Ernest Prabhakar]
+
-
* [http://members.optusnet.com.au/benjamincarlyle/benjamin/blog/ Benjamin Carlyle]
+
-
= Purpose =
+
== closed issues ==
-
Questions or comments about [[hatom|hAtom]] go here. Please add your name
+
See: [[hatom-issues-closed]]
-
to the [http://microformats.org/wiki?title=hatom-issues&action=edit&section=4 Contributors] section above.
+
-
== Goals for hAtom ==
+
== resolved issues ==
-
# to provide a blog-post microformat, based on how people actually produce weblogs
+
See: [[hatom-issues-resolved]]
-
# based on (1), use Atom as it provides the most suitable data model for doing so
+
-
# based on (2), to make the format useful anywhere Atom might be used in context to create a syndication feed
+
-
# provide a baseline envelope format for similar {title|link|content|summary} web pages
+
-
== Anti-Goals for hAtom ==
+
== issues ==
-
# <em>Not</em> to tell people how to write blogs or what there blog should look like; hAtom marked up blogs should look and behave <em>identically</em> to what they before hAtom was applied.
+
<span id="Issues">Please add new issues</span> to the '''bottom''' of the list by copy and pasting the [[#Template|Template]].  Please follow-up to resolved/rejected issues with new information rather than resubmitting such issues.  Duplicate issue additions will be reverted.
-
= New Nomenclature =
+
===2010===
 +
==== No defined parsing rule for <code>updated</code> timestamps in <code>ins</code>elements ====
 +
* {{OpenIssue}} 2010-01-20 raised by [[User:BenWard|BenWard]]
 +
*# hAtom includes the <code>updated</code> property for the last modification/revision date of an entry. HTML already has an <code>ins</code> element for marking up inserted changes to text, and that element has a <code>datetime</code> attribute, to document the date and time of the change. Currently, hAtom and microformats have no model for parsing the data from that <code>datetime</code> attribute, but the document semantics suggest it would be an appropriate source for the <code>updated</code> property. Example: <http://blog.benward.me/post/250674456>
 +
*#* Proposed resolution. Document a parsing rule for the <code>ins</code> element, stating that for an <code>ins</code> (or <code>del</code>) element with class of <code>updated</code>, the value of the <code>datetime</code> attribute should be used as the value.
 +
*#** +1 This sounds like a good idea and something worthy of being incorporated into [[hcard-parsing#more_semantic_exceptions]] (which is where the core of generic microformat parsing is currently documented) for special handling for all datetime properties. [[User:Tantek|Tantek]] 17:43, 21 January 2010 (UTC)
 +
*#* This has been supported by Swignition for well over a year, and is supported by HTML::Microformats. [[User:TobyInk|TobyInk]] 23:00, 21 March 2010 (UTC)
 +
*#* Proposed extended resolution: As well as the above explicit parsing rule, an implication parsing rule stating that where <code>update</code> is not explicitly marked up, the parser may aggregate all <code>ins</code> and <code>del</code> elements in the <code>hentry</code>, and use the most recent <code>datetime</code> attribute content as the <code>updated</code> value.
 +
*#** +1 Brilliant. Indeed right now 'updated', if missing, is implied from the 'published' property.  Suggested change to that rule (incorporating your proposal) : if 'updated' is missing, use the latest in time value of: the 'published' property value, and the 'datetime' attributes of all ins and del elements inside the hentry. [[User:Tantek|Tantek]] 17:43, 21 January 2010 (UTC)
-
[[User:DavidJanes|David Janes]] added this on 2006.01.03. Since we've decided that correspondence to Atom nomenclature is not going to happen, let's just decide on it here. I tried but probably haven't succeeded in pulling all the info from below up so feel free to add new things. Also feel free to change your vote if you see a consensus happening.
+
<div class="hentry">
 +
{{OpenIssue}}
 +
<span class="entry-summary author vcard">
 +
<span class="published">2010-03-20</span>
 +
raised by <span class="fn">[[User:Singpolyma|Singpolyma]]</span>
 +
</span>
 +
<div class="entry-content discussion issues">
 +
* <strong class="entry-title">Should we talk about parsing of &lt;time&gt; element?</strong>. I use this element to mark up published on my blog. It is not supported by any implementation that I know of.  Should implementors be encouraged to add this?  Should the spec talk about it as an alternative to datetime-design-pattern?  That page currently says to check the hcal issues, but there is nothing there about it.
 +
** Swignition has supported this for well over a year. It's also been supported in HTML::Microformats since version 0.00_00. [[User:TobyInk|TobyInk]] 23:00, 21 March 2010 (UTC)
 +
</div>
 +
</div>
-
'''How to use this'''. If you like a particular use, place something like '<code>: +1 YourName</code>' following the name. Feel free to make as make negative votes. If you have something compelling to say, add it to the Discussion section that follows. Let's settle this out by, say the 10th of January 2006?
+
===2009===
 +
==== too many required hentry properties ====
 +
* {{OpenIssue}} 2009-05-26 raised by [[User:Tantek|Tantek]]
 +
*# hAtom 0.1 requires numerous properties for an hentry (often based directly on required elements from the Atom standard). Given the broad variety of situations that hAtom is used in content, many (or even most) of these properties are not already specified in such content, and thus it is poor methodology to require them because there is a good chance (experience has shown) either (a) the content author will ignore the requirement, or (b) will make something up to satisfy the requirement.  A few similar/overlapping/sub-issues are noted below (e.g. [[#Author|author is required]], and not always available).
 +
*#* Proposed resolution. Make nearly all hentry properties "optional" in hAtom 0.2. Consider keeping at most only one required property, perhaps "updated" - that is, if there is no date of update/publication in the content you are trying to mark up, then perhaps it doesn't make sense to mark up that content with hAtom, since hAtom is for episodic, time-based/stamped content.
 +
*#** consider pattern abstraction: all microformats should minimize "required" properties for the same reason, and perhaps ''only'' require at most a single property which is indicative of what that microformat is for, that is, if the author does not publish that one required property, then perhaps they should not be using the microformat that requires that one property.
 +
*#* I have the same problem. I'm collecting various feeds to analyse them. The sources are often RSS 0.9, but I want to put the results into an Atom feed. --[[User:Simon Brodtmann|Simon Brodtmann]] 00:51, 1 July 2009 (UTC)
 +
*#** entry:author should be optional and could be either a hCard or a string
 +
*#** entry lacks a [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.category category] and it shuld either use rel-tag or just be a string
 +
* 2009-07-18 [[User:DavidJanes]] I would like to break this into a separate issue for each currently required element, as we're likely to have to define defaulting rules
 +
* 2009-07-21 [[User:TobyInk|TobyInk]]: Why not have three levels of property: ''required'', ''recommended'' and ''optional''. There would be as few as possible ''required'' properties. Any properties which are needed to create a conformant application/atom+xml feed would be ''recommended''. Everything else would be ''optional''.'
 +
** 2009-07-02 [[User:DavidJanes]] why not then use the RFC MUST, SHOULD and MAY terminology? I think this is a good idea though.
 +
** 2009-09-03 [[User:Chris Cressman|Chris Cressman]] +1 to the idea of property "levels" and reusing RFC terminology.
-
== Feed (atom:feed)==
+
==== entry-title optionality ====
-
* <code>class="feed"</code> (Atom consistency)
+
* {{OpenIssue}} 2009-07-18 raised by [[User:DavidJanes]]
-
* <code>class="atom-feed"</code> (Atom consistency with prefix)
+
** this element should be optional
-
* <code>class="hfeed"</code> (h* uF consistency)
+
*** +1 [[User:DavidJanes]]
-
: +1 DavidJanes
+
*** +1 [[User:WebOrganics|Martin McEvoy]] but not recommended.
-
: +1 Tantek
+
*** +1 [[User:Bmearns|Bmearns]] I think this format has much broader application without this limitation. I'm thinking, for instance, of the Facebook news feed, or a twitter feed, both of which could use this microformat but do not in general have titles for each post.
-
: +1 BenjaminCarlyle
+
*** ... your vote here ...
-
: +1 MarkRickerby
+
** if this element is not in the [[hatom#In_General|physical model]], the logical model value should be
 +
*** the empty string
 +
**** +1 [[User:DavidJanes]]
 +
**** -1 [[User:WebOrganics|Martin McEvoy]]
 +
*** the value should not be blank.
 +
**** +1 [[User:WebOrganics|Martin McEvoy]] see: [http://www.atomenabled.org/developers/syndication/#requiredEntryElements Required Entry Elements] from Atom Enabled.
 +
**** [[User:DavidJanes]] what should it be then, if physically representing it is optional? Since Atom makes this a SHOULD and not a MUST (I'm not shouting, just following RFC convention), and we're assuming there's a good reason for the entry-title not to be present in the first place, why not an empty string?
 +
***** [[User:WebOrganics|Martin McEvoy]] entry:title is a required attribute of atom at both feed and entry level, in both instances it says "Contains a human readable title" (a requirement) an empty string is not anything human readable (personal oppinion), maybe hAtom 0.2 should only recommend that the value of entry-title "should" not be an empty string.
 +
*** the value should be NULL.
 +
**** +1 [[User:Bmearns|Bmearns]]: Whatever that may mean to the specific handler. A blank string implies that a handler which generates HTML content, for instance, should generate <code>&lt;H1&gt;&lt;/H1&gt;</code>, as opposed to just omitting the title all together.
 +
*** ... your proposal here, your vote in a sublist ...
 +
* include in hAtom 0.2
 +
** +1 [[User:DavidJanes]]
 +
** +1 [[User:WebOrganics|Martin McEvoy]]
 +
** +1 [[User:Bmearns|Bmearns]]
-
=== Discussion ===
+
==== updated optionality ====
 +
* {{OpenIssue}} 2009-07-18 raised by [[User:DavidJanes]]
 +
** this element should be optional
 +
*** +1 [[User:DavidJanes]] ... the demand for optionality of the issue is high (cf the microsoft web clips) and if it remains required we're just going to reinvent hAtom without this element
 +
*** +1 [[User:Chris Cressman|Chris Cressman]] Agree there is demand for optionality. This requirement has previously deterred me from using hAtom.
 +
** if this element is not in the [[hatom#In_General|physical model]], the logical model should be
 +
*** the page creation date
 +
**** +1 [[User:DavidJanes]]
 +
**** +1 [[User:Chris Cressman|Chris Cressman]]
 +
*** ... your proposal here, your vote in a sublist ...
 +
* include in hAtom 0.2
 +
** +1 [[User:DavidJanes]]
 +
** +1 [[User:Chris Cressman|Chris Cressman]]
-
== Entry (atom:entry) ==
+
==== author optionality ====
-
* <code>class="entry</code> (Atom consistency)
+
* {{OpenIssue}} 2009-07-18 raised by [[User:DavidJanes]]
-
: +1 MarkRickerby
+
** this element should be optional
-
* <code>class="atom-entry</code> (Atom consistency with prefix)
+
*** +1 [[User:DavidJanes]] for the same reason 'updated' should be optional: we'll just reinvent hAtom slightly differently otherwise
-
* <code>class="hentry</code> (h* uF consistency)
+
*** +1 [[User:Chris Cressman|Chris Cressman]] Same reason as 'updated' above.
-
: +1 DavidJanes
+
*** ... your vote here ...
-
: +1 Tantek
+
** if this element is not in the [[hatom#In_General|physical model]], the logical model should be
-
: +1 BenjaminCarlyle
+
*** "anonymous" (somewhat like [[hreview]]), except not explicit
 +
**** +0.5 [[User:DavidJanes]]
 +
**** 0 [[User:Chris Cressman|Chris Cressman]] Using a blog post as an example, I can determine the author from surrounding context. 'Anonymous' doesn't seem like an acceptable solution. However, I don't have the technical expertise to create a better solution and would be willing to accept 'anonymous'.
 +
*** make this implementation defined
 +
*** something constructed from the page's URL & other information
 +
*** ... your proposal here, your vote in a sublist ...
 +
* include in hAtom 0.2
 +
** +1 [[User:DavidJanes]]
 +
** +1 [[User:Chris Cressman|Chris Cressman]]
-
=== Discussion ===
+
=== 2008 ===
 +
==== add url property to hentry ====
 +
* {{OpenIssue}} 2008-09-10 raised by [[User:Tantek|Tantek]]
 +
*# hAtom 0.1 uses [[rel-bookmark]] for permalinks.  Permalinks may not always be hyperlinks or hyperlinkable.  Thus I propose we re-use the <code>url</code> property (from [[hCard]], [[hCalendar]], [[hReview]], etc.) as a sub-property of the <code>hentry</code> property/container/root.
 +
*#* Proposed resolution. Add "url" sub-property to "hentry" in hAtom 0.2.
 +
*# {{ToDo}} can anyone provide examples where this would be used? [[User:DavidJanes]]
-
== Entry Title (atom:title) ==
+
==== misuse of address element ====
-
* <code>class="title"</code> (Atom consistency)
+
* {{OpenIssue}} 2008-06-07 raised by [[User:Tantek|Tantek]]
-
* <code>class="entry-title"</code> (Atom consistency, avoid hCard conflict)
+
*# hAtom 0.1 says "an Entry Author element SHOULD be encoded in an <code>&lt;address&gt;</code> element" and "find the Nearest In Parent <code>&lt;address&gt;</code> element(s) with class name author and that is/are a valid hCard" - this is a misuse of the address element.  The address element means the ''contact'' for the page or major portion thereof (see [[hcard-faq#Should_I_use_ADDRESS_for_hCards|hCard FAQ: Should I use ADDRESS for hCards]]), which ''may'' also be the ''author'' but is not necessarily.  See [[hcards-and-pages]] for more details on this semantic distinction.
-
* <code>class="heading"</code> (HTML)
+
*#* Proposed resolution: Eliminate all requirements and recommended use of the <code>&lt;address&gt;</code> element from hAtom.
-
* <code>class="subject"</code> (RFC822)
+
*#** +1 --[[User:Csarven|Sarven Capadisli]] 11:57, 11 Nov 2008 (PST)
-
* <code>class="summary"</code> (hReview consistency)
+
*#** +1 [[User:DavidJanes]]
-
: -1 KevinMarks (clashes with atom)
+
*#** +1 [[User:Chris Cressman|Chris Cressman]] Prefer microformat solutions that don't dictate specific elements.
-
* <code>class="headline"</code> what they're called in the News/Journalism industry
+
* include in hAtom 0.2
-
: +1 Tantek
+
** +1 [[User:DavidJanes]]
-
: +1 BenjaminCarlyle
+
** +1 [[User:Chris Cressman|Chris Cressman]]
-
: +1 KevinMarks
+
-
* <code>class="fn"</code> hReview item consistency
+
-
=== Discussion ===
+
=== 2007 ===
-
BenjaminCarlyle: If one were to review a blog entry with hReview we would fill out the "fn" field with the atom:entry/title. This suggests to me that fn may be sufficient for this title usage. headline is more semantically specific, and does seem appropriate. It may be a line-ball call as to whether a new term is required, or whether the atom:entry context is sufficient to indicate the fn is also a headline.
+
==== marking up comments ====
 +
* {{OpenIssue}} 2007-11-25 raised by [http://www.wirewd.com/ Ken Wronkiewicz].
 +
*# There's no currently defined way to exactly handle threaded discussions.  I think this is quite useful to have.
 +
*#* The prior art is RFC [http://tools.ietf.org/html/rfc4685 4864].  The microformat solution should map fairly cleanly to this.
 +
* include in hAtom 0.2
 +
** -1 [[User:DavidJanes]] I think hAtom Comments should be a separate spec
 +
*** +1 to David's -1. [[User:TobyInk|TobyInk]] They're in a separate RFC, so should be separate to hAtom too. That said, it would be nice if hAtom had a clear, documented mechanism for creating extensions.
 +
** +1 [[User:Singpolyma|Singpolyma]] Comments are the important "next step" for hAtom.  The proposal I've seen that I most liked was embedding an hfeed in an hentry.
 +
*** [[User:DavidJanes]] would you look to explicitly write out that proposal here (or in a new section); this is my preferred solution too, but there's another proposal on the table for doing this too
-
BenjaminCarlyle: Are we considering atom:feed/title in this discussion? There is some suggestion that atom:title should be "fn", separate to any value of atom:entry/title.
+
==== atom:category scheme ====
 +
* {{OpenIssue}} 2007-06-01 raised by [http://theryanking.com/ Ryan King].
 +
*# ''[[rel-tag#Tag_Spaces|rel-tag tagspaces]] should map to atom:category schemes''
 +
*#* hAtom already defines how to map term and label. It seems that the tagspace can easily map to scheme
 +
*# {{ToDo}} can we get a real-world example mapping of this? [[User:DavidJanes]]
-
== Entry Content (atom:content) ==
+
=== 2006 ===
-
* <code>class="content"</code> (Atom consistency)
+
====Geo====
-
: +1 Tantek
+
* {{OpenIssue}} 2006-02-03 raised by [[BrianSuda]]
-
: +1 DavidJanes
+
** We can use the [[geo]] microformat in [[hatom]] to represent GeoRSS element
-
* <code>class="description"</code> (vCalendar, hCalendar, xFolk, hReview consistency)
+
** +1 [[User:DavidJanes]] - this is just making explicit a particular composition. is it not? Also: if there's a geo in a hfeed (outside of hentry), should it be considered to apply to all entries?
 +
** +1 [[User:Chris Cressman|Chris Cressman]]
 +
* include in hAtom 0.2
 +
** +1 [[User:DavidJanes]]
 +
** +1 [[User:Chris Cressman|Chris Cressman]]
-
=== Discussion ===
+
==== Relationship of rel-bookmark to url+uid ====
-
It turns out there is actually a very fine semantic distinction between the way "description" is used in vCalendar, hCalendar, xFolk, hReview, and what "content" means. In short, those other microformats are all "about" something else, whether an actual event in spacetime, or another item.  Whereas in hAtom is the thing itself.  The feed is the data is the item.  Thus it makes sense use a different class name than "description".  Based on our [[naming-principles]], lacking an existing microformat term for this, we should use a term from a standard.  Since Atom uses "content", that is the logical name to bring over and use, whether or not it is "perfect" to capture the semantic we are trying to capture. - Tantek
+
The concept of permalink is available in hCard and hCalendar as the classes url and uid. This combination matches the permalink semantics by indicating that the url should be derefenced to find a more dynamic or up-to-date version of the content, and that that url is a stable unique id that can be used to identify the content.
-
BenjaminCarlyle: We may also have to consider forms of blogs that carry other media. An <a rel="content" href="..."/> form of content may also have to be considered, although this could still be embedded in a very short html content block. I'm not quite ready to commit to "content" yet, but I agree that description may be a little weak.
+
hAtom 0.1 uses rel-bookmark for the permalink concept. The current state of [[uid-brainstorming]] indicates that the [[hCard]] and [[hCalendar]] permalink concept is likely to be used in subsequent microformats. It may be important to reconcile hAtom with that trajectory. Possible reconcilliations include:
-
== Entry Summary (atom:summary) ==
+
1) To leave things as they are. The two permalink concepts are to be kept separate.
-
* <code>class="summary"</code> (Atom consistency)
+
-
* <code>class="content-summary"</code> (Atom consistency avoiding hCalendar conflict)
+
-
* <code>class="partial-description"</code>
+
-
* <code>class="excerpt"</code>
+
-
: +1 Tantek
+
-
: +1 BenjaminCarlyle
+
-
* <code>class="abstract"</code>
+
-
: +1 KevinMarks
+
-
=== Discussion ===
+
2) Treat the two concepts as equivalent. Allow both in hAtom, and consider allowing both in other formats. eg &lt;a rel="bookmark" href="http://example.com/"> would fill out uid and url values if they are not supplied explicitly.
-
Excerpt is by far the most frequent (>80%) use of summary, thus it makes sense to name it as such. - Tantek
+
-
Disagree - Atom allows summary to be distinct from content, though this is less usual. However, by using a class that means summary (eg abstract) we cna convey an excerpt by making  it wholly within 'atom:content', or a separate abstract by putting it within the entry but not within 'content' [[User:Kevin Marks|Kevin Marks]]
+
3) Choose one over the other for hAtom and perhaps for future microformats also. "url uid" allows for some greater freedom (uid can be pointed at a non-url uid), but it is unclear at this stage whether that freedom is warranted or advisable to permit.
-
BenjaminCarlyle: I have been trying to convince meyself that atom:summary differs semantically from iCalendar summary. The "summary or subject" wording from rfc2445 is problematic, and it seems earlier microformats have taken the "subject" side. If we were to start from rfc2445 alone we might go the other way. In the end, though, webster.com describes summary as "covering the main points succinctly". atom:summary is not really consistent with that definition, so I'll swing my weight behind excerpt.
+
* include in hAtom 0.2
 +
** -1 [[User:DavidJanes]] (let's wait for resolution elsewhere, also would need real world examples)
 +
** -1 [[User:Singpolyma|Singpolyma]]
-
== Entry Permalink (atom:link) ==
+
==== Datetime format (atom:<i>updated</i> and atom:<i>published</i>) ====
-
* <code>rel="bookmark"</code> (HTML consitency)
+
* 2006-05-23 raised by [[User:RobertBachmann|Robert Bachmann]]
-
: +2 DavidJanes
+
** Atom requires the use RFC3339 datetimes, while hAtom 0.1 does not specify which datetime formats may be used.
-
: +1 Tantek
+
*** ACCEPTED FAQ - hAtom references datetime-design-pattern, which discusses which date format to use
-
: +1 BenjaminCarlyle
+
** 2009-07-20 [[User:DavidJanes]] {{ToDo}} is this moot? can we move this to resolved?
 +
==== Feed <i>id</i> (atom:<i>id</i>) ====
 +
* {{OpenIssue}} 2006-04-01 raised by [[User:RobertBachmann|Robert Bachmann]]
 +
*# atom:<i>id</i> is required for atom:feed. Thus it should be available in hAtom to.
-
=== Discussion ===
+
It is suggested the Feed permalink should be used as the feed ID, however a piece by Mark Pilgrim (http://diveintomark.org/archives/2004/05/28/howto-atom-id) makes arguments against using permalinks and in favour of Tag URIs.
-
BenjaminCarlyle: No real contraversy here, unless you want to start giving blog entries or feeds vcards. A vcard could contain entry or feed title as fn, as well as url.
+
-
== Entry Published (atom:published) ==
+
* include in hAtom 0.2
-
* <code>class="published"</code> (Atom consistency)
+
** -1 [[User:DavidJanes]] not enough development of these ideas yes
-
: +1 Tantek
+
-
* <code>class="dtpublished"</code> (Atom consistency with "dt" unofficial pattern)
+
-
=== Discussion ===
+
==== Feed <i>permalink</i> (atom:<i>permalink</i>) ====
-
BenjaminCarlyle: I would still like to see a clear engagement with [[last-modified-brainstorming|last-modified]] before voting on this one.
+
* {{OpenIssue}} 2006-04-01 raised by [[User:RobertBachmann|Robert Bachmann]]</small>
 +
** I'm proposing the following rules:
 +
**# a Feed Permalink element is identified by [[rel-bookmark]] at the feed level (inside a Feed element but not inside an Entry element)
 +
**# a Feed <del>SHOULD</del><ins>MAY</ins> have a Feed Permalink
 +
**# a Feed Permalink element represents the concept of an Atom link in a feed.
 +
**# if the Feed Permalink is missing, use the URI of the page; if the Feed has an "id" attribute, add that as a fragment to the page URI
 +
** 2006-04-03 [[User:ChrisCasciano|ChrisCasciano]] - I'm not sure that having a rel-boomkark-able link element at the feed level / to designate a feed in an html page separate for the other content is anything close to normal usage on the web, so I'd be very hesitant on suggesting this element "SHOULD" exist. I'm also curious when this element would link to anything but the current page (or some element on the current page) for this to be useful in the context of the HTML doc. I think taking the "id" on the feed is a more workable solution in most cases.
 +
** 2006-04-03 [[User:RobertBachmann|Robert Bachmann]]: I've replaced "SHOULD" with "MAY".
 +
** 2006-04-24 [[User:RobertBachmann|Robert Bachmann]]: Maybe we could simplify my proposal to:
 +
*** "''Use the URI of the page; if the Feed has an "id" attribute, add that as a fragment to the page URI''"
 +
*** IMO this would be good enough for at least 80% of the cases.
 +
** 2006-04-12 [[User:DavidJanes]]: {{ToDo}} can we find an example of this in the wild and if so we should add it to the -examples page.
 +
** [[User:Singpolyma|singpolyma]] 00:05, 13 Apr 2006 (PDT) : since the link is going to be pointing to the home page for the item wouldn't [[rel-home]] make more sense?  That's what I'm using in the XOXO Blog Format and my reasoning was that if hAtom ever defined this rel=home made the most sense for what you would add, because the feed's link is not to a part of the site by to the home of the site.
-
== Entry Updated (atom:updated) ==
+
* include in hAtom 0.2
-
* <code>class="updated"</code> (Atom consistency)
+
** -1 [[User:DavidJanes]] not enough development of these ideas yes
-
: +1 Tantek
+
-
* <code>class="dtupdated"</code> (Atom consistency with "dt" unofficial pattern)
+
-
* <code>class="last-modified"</code>
+
-
=== Discussion ===
+
==== Feed <i>updated</i> (atom:<i>updated</i>) ====
-
BenjaminCarlyle: I would still like to see a clear engagement with [[last-modified-brainstorming|last-modified]] before voting on this one.
+
* {{OpenIssue}} 2006-04-01 raised by [[User:RobertBachmann|Robert Bachmann]]
 +
** atom:<i>updated</i> is required for atom:feed. Thus it should be available in hAtom to. I'm proposing the following rules:
 +
**# The Feed Updated element is identified by the class name <code>updated</code> at the feed level (inside a Feed element but not inside an Entry element)
 +
**# If no element with the class name <code>updated</code> is present, use the youngest <code>updated</code> from the feed's entries.
 +
** 2006-04-12 [[User:DavidJanes]] I like this. And the definition of "feed level"
 +
** 2007-06-20 [[User:MikeKaply]] The "youngest" thing is a really bad idea. If a page has 100 hAtom entries, a parser would have to go through all 100 looking for a low date. That's crazy.
 +
*** 2008-03-20 [[User:TobyInk]] Not crazy at all. I've just implemented an hAtom to Atom converter and I do precisely this. Most (useful) hAtom parsers will "go through all 100 entries" anyway, won't they? So why not look for the youngest updated date as part of that loop. The only slight annoyance is that in RFC 4287, the &lt;atom:updated> element must occur before the first &lt;atom:entry> element -- this is easily solved by inserting a placeholder &lt;atom:updated> element, looping through the entries and then going back and filling in the date. This is really, really, '''not''' a difficult thing to implement.
-
== Entry Author (atom:author) ==
+
* include in hAtom 0.2
-
* <code>class="author"</code> (Atom consistency)
+
** +0.5 [[User:DavidJanes]]
-
: +1 Tantek
+
-
=== Discussion ===
+
==== Feed <i>title</i> (atom:<i>title</i>) ====
-
BenjaminCarlyle: I think an author concept is generally useful to microformats, so long as you can make it clear whether it is the author of the uf wrapper or the author of the uf content that is being described. I think any wavering over whether author and contributor are both required is probably a step outside the atom specification. This may be worthwhile, with an xfn-style external definition that could relate a person to a work... or even a rel-tag-based relationship. Can room be left open for both of these possibilities for future expansion, while still providing a clear author -> atom:author translation?
+
* {{OpenIssue}} 2006-04-01 raised by [[User:RobertBachmann|Robert Bachmann]]
 +
** atom:<i>title</i> is required for atom:feed. Thus it should be available in hAtom to. I'm proposing the following rules:
 +
**# a Feed Title element is identified by the class name <code><del>entry</del><ins>feed</ins>-title</code>
 +
**# a Feed SHOULD have an Feed Title
 +
**# a Feed Title element represents the concept of an Atom feed title
 +
**# if the Feed Title is missing, use
 +
**#* <del>the first <code>&lt;h#></code> element in the Feed, or</del>
 +
**#* the <code>&lt;title></code> of the page, or
 +
**#* assume it is the empty string
 +
** 2006-04-01 [[User:ChrisCasciano|ChrisCasciano]] - I think that the fall back to using the first h# on the page is dangerous.. depending on the pge it may be something that changes often (first h# is a post title) or is otherwise ambiguous. I would think using <code>&lt;title></code> before h# would be prefered if not the most common desire of the page author.
 +
** 2006-04-05 [[User:RobertBachmann|Robert Bachmann]]: Okay. Deleted "the first <code>&lt;h#></code> element in the Feed, or"
 +
** 2006-04-12 [[User:DavidJanes]] Note also in support of this decision that many blogs use <code>&lt;h#></code> to encode the date for a group of postings
 +
** 2006-04-12 [[User:DavidJanes]]: why <code>entry-title</code> for the feed title. Why not <code>fn</code> or <code>feed-title</code>?
 +
** 2006-04-12 [[User:RobertBachmann|Robert Bachmann]]: Sorry, this was a "copy & paste" mistake. Fixed now.
 +
** 2007-02-26 [[User:MikeKaply|Mike Kaply]]: I think a feed title should be mandatory if an hfeed is present. If you have multiple feeds on a page, there is no way in a user interface to distinguish between different feeds.
-
== Entry Contributor (atom:author) ==
+
==== Feed <i>author</i> and Entry author (atom:<i>author</i>) ====
-
* <code>class="contibutor"</code> (Atom consistency)
+
* {{OpenIssue}} 2006-04-01 raised by [[User:RobertBachmann|Robert Bachmann]]
-
: -1 Tantek - recommend postpone from hAtom first version, since the 80% case does not need "contributor".  We can always add it later if we need it.
+
** I'm proposing the following rules for Feed author:
 +
**# a Feed Author element is represented by class name <code>author</code> at the feed level (inside a Feed element but not inside an Entry element)
 +
**# a Feed Author element represents the concept of a Atom author
 +
**# a Feed Author element MUST be encoded in a [[hcard|hCard]]
 +
**# a Feed Author element SHOULD be encoded in a <code>&lt;address></code> element
 +
**# a Feed MAY have more than one Feed Author elements
 +
**# if the Feed Author is missing
 +
**#* find the [[algorithm-nearest-in-parent|Nearest In Parent]] <code>&lt;address></code> element(s) with class name <code>author</code> and that is/are a valid [[hcard|hCard]]
 +
**#* otherwise <del>the Feed is invalid hAtom</del> <ins>there is no Feed Author</ins>
 +
** I'm proposing the following rules for entry author:
 +
**# an Entry Author element is represented by class name <code>author</code>
 +
**# an Entry Author element represents the concept of an Atom author
 +
**# an Entry Author element MUST be encoded in an [[hcard|hCard]]
 +
**# an Entry Author element SHOULD be encoded in an <code>&lt;address></code> element
 +
**#<del> If a Feed has no Feed author each Entry MUST have at least one Entry Author element</del>
 +
**# <ins>If an Entry is enclosed by a Feed and this Feed has no Feed author, each Entry MUST have at least one Entry Author element. If an Entry is not enclosed by a Feed and has no Entry Author:
 +
**#* find the [[algorithm-nearest-in-parent|Nearest In Parent]] <code>&lt;address></code> element(s) with class name <code>author</code> and that is/are a valid [[hcard|hCard]]
 +
**#* otherwise the Entry is invalid hAtom</ins>
 +
**# an Entry MAY have more than one Entry Author elements
 +
** [[User:Singpolyma|singpolyma]] 00:11, 13 Apr 2006 (PDT) : feed should not be invalid hAtom if feed-level has no author -- it should be invalid if feed-level has no author AND one or more entries have no author. Also, one or more entries may be missing an author IF feed-level has an author.
 +
** 2006-04-17 [[User:RobertBachmann|Robert Bachmann]]: I replaced "the Feed is invalid hAtom" with "there is no Feed Author"
-
=== Discussion ===
+
==== Entry <i>id</i> (atom:<i>id</i>) ====
 +
* {{OpenIssue}}2006-04-01 raised by [[User:RobertBachmann|Robert Bachmann]]
 +
** atom:<i>id</i> is required for atom:entry. Thus it should be available in hAtom to. The Entry permalink should be used as the entry id.
 +
** --[[User:Federico|Federico]] 19:52, 25 Apr 2006 (PDT): I would add "Only if the id attribute is not defined for the element that contains the entry". The id attribute can be a tag uri. If you use always use the Entry permalink as the entry id and the Atom feed uses tag uris, you would end with two different ids for the same entry.
 +
** 2006-12-31 response by [[User:ComputerKid|Emanla Eraton]] No, it shouldn't be a permalink. It should be a "tag:" id for entries.
 +
** 2007-06-06 [[RyanKing]] - the syntax of tag URIs and html id attributes are incompatible. HTML disallows forward-slash (/) in ids [http://www.w3.org/TR/html401/types.html#type-name], while tag URIs require them [http://www.faqs.org/rfcs/rfc4151.html].
-
= Questions and Comments =
+
==== Author ====
 +
===== author as an hcard is too much to require =====
 +
The following 3 items were extracted from the conversation starting on irc with [http://rbach.priv.at/Microformats-IRC/2006-03-24#T152248 logs available starting around here]
-
==Limitations==
+
* [[User:Fil|Fil]] If, for example, you are programming an "aggregator" of news syndicated from many sources like in [http://sedna.spip.org/sedna/ Sedna], chances are that you don't control what "authors" look like; they can be nicely microformated (if coming from an mf-enabled system), but most probably they will be internally represented by a string that contains, in some random order, a name, and/or an email, and so on. If you want to pass on this information in an hAtom feed, you can't possibly reformat it to an hCard. But you still want to pass it on in a &lt;div class="author"> element.
-
There seems to be nothing in the hAtom specification to supply metadata for the blog (title, description, url, feedurl).
+
** [[Tantek]] I don't believe the "can't possibly" statement.  Please provide a URL to a concrete example that you think you can't possibly reformat into an hCard so we can all take a look.
-
There is nothing defined for the encapsulation of comments, comment counts, or links to comment sections.
+
** [[User:ChrisCasciano|ChrisCasciano]] details of Fil's extraction [http://rbach.priv.at/Microformats-IRC/2006-03-24#T153453 in irc logs] including sting data passed to his app in the form of "Béatrice XXXXXXX beatrice.xxxxxx@@zzzzzzzzz.com"
-
The microformat would be much more useful with these capabilities added.
+
** [[User:Fil|Fil]] the example url was given up there (Sedna); note that the author information comes from syndication links; nobody is going to edit them to outline what is the name, what is the email and so on, as everything is flowing through automatically... so here the "author" data is dirty, and will not be cleaned into an hCard. We can force it to be in an hCard but it will be meaningless if the source (original data) wasn't built on an mf-enabled software.
-
-- [[User:Singpolyma|singpolyma]] 03:35, 3 Jan 2006 (PST)
+
-
* We've deliberately restricted this to being a "blog post" microformat at this point to make the problem managable. Once the core elements are defined, we will consider extended the spec to cover as much as Atom does. Also note that microformats are compositable, thus, all these things could potentially be defined elsewhere with detrement to this standard. -- DavidJanes
+
* [[pnhChris]] i don't disagree.. the field often comes from places too dumb to follow these rules well; even cases like wordpress that allow users to present their name 1 of 6 or 8 difference ways (from username to LF, FN) .. its not just writing a template to output as hatom at that point... you have to go further upstream where the string to be displayed is chosen .. I also think its pointless to have 10 vcards on the same page whose only data is a generic name like "Chris"
-
** You brought this microformat to my attention because you disagreed in priciple with the XOXO Blog Format (http://blogxoxo.blogspot.com/2006/01/xoxo-blog-format.html)...  yet the only tool that currently works with that format works with comments.  note also that at ''least'' comment counts and links to comment sections are part of posts.  If you don't want to encapsulate comments I suppose I understand that and can easily create my own format meant to be embedded in yours to facilitate this purpose :) -- [[User:Singpolyma|singpolyma]] 22:13, 3 Jan 2006 (PST)
+
** [[Tantek]] 10 vcards that are the same is pointless yes, but identifying who the author of 10 posts are is not pointless - that's the difference.
-
** Where did I disagree in principle? A: I told you about the existence of hAtom. B: I mentioned several of the design goals for hAtom
+
** [[User:ChrisCasciano|ChrisCasciano]] Agreed, but I still have concerns that "author" in hAtom does not always make for good hCards, though the situations where it does is optimal. My comments in the conversation were old comments I've made before over concerns and hardships or the lack of desire to make crappy data more portable, in neither of these cases do I think my two comments alone provide reasons to make change from the hAtom 0.1 spec
 +
***[[User:Phae|Frances]] - Just thought I'd mention a scenario I have where the author of an entry does make a pretty useless vCard - the author in each case is an entire team ("creative team", "technical department") etc., rather than a specific, identifiable, person.  Some use may be regained when URL to specific team/information is included, in this circumstance.
 +
****[[User:TobyInk]] - A vCard (thus an hCard) does not have to represent a person -- it could represent an organisation, or a department or team.
 +
* [[User:Fil|Fil]] for the moment, to comply losely with hAtom 0.1, I will use <code><nowiki><span class="author"><span class="vcard"><span class="fn">My Name</span></span></span></nowiki></code> ; but it's not good
 +
** [[Tantek]] You can actually simplify that (one fewer span) with: <code><nowiki><span class="author vcard"><span class="fn">My Name</span></span></nowiki></code>
-
== Nomenclature ==
+
* require author as [[hCard]] (i.e. no change from 0.1)
 +
** +2 [[User:DavidJanes]]
-
Note: microformats [[naming-principles]] include a precise means for coming up with names which should work in the 90% case.
+
==== Entry <i>source</i> (atom:<i>source</i>) ====
 +
* raised by [[User:Kevin Marks|Kevin Marks]]
 +
** When defining hAtom 0.1, atom:source was omitted. We should consider adding this back in as a useful element for providing citations of composite feeds.
 +
*** 2009-07-20 [[User:DavidJanes]] {{ToDo}} we need an example of how this would look in the real world
-
One point to raise for hAtom in particular - we don't simply omit spaces from multiword property names, we use hyphens. E.g. "given-name" and many others in [[hcard|hCard]].
+
== Other Questions and Issues ==
 +
General comments, modeling issues, algorithm issues, should have issues, etc. go here.
-
=== Why atomentry? ===
+
=== Entry Updated Required? -- Blogger Issue ===
-
;class="atomentry" (or rather, "atom-entry")
+
moved to [[hatom-brainstorming]]
-
:Why not simply "entry"? The parallel to Atom is clear, but in the
+
-
context of a Web page, why add the reference? In case maybe you want
+
-
to try for something approaching a string that won't get confused, my
+
-
feeling is: forget it. Stick to the local semantics and let the
+
-
doc-level (or HTML5 div level?) profile attribute disambiguate. Or to
+
-
put it another way, it's premature to see a need at that point.
+
-
-- [[DannyAyers]]
+
-
* I ([[User:DavidJanes|David Janes]]) chose the "atom" prefix:
+
=== 'MAY have multiple Feed elements' -- details and viability of multiple feeds ===
-
** to disambiguate; it is just ''too'' likely that "entry" or "feed" would appear on a random webpage in some other context. My preference would be to have a declarative statement in the XHTML header which would render this argument moot, but at this point the community seems cool on the concept.
+
moved to [[hatom-brainstorming]]
-
** to follow the naming pattern seen in the other "major" microformats ([[hcard|hCard]], [[hcalendar|hCalendar]], etc.)
+
-
** because Entrys will not be required to be in Feeds (these rules and the reasons where this can happen will be forthcoming), I choose to disambiguate both
+
-
::I don't like the analogy; I think this is more useful than just Atom, so it should be made generic. [[User:DrErnie|Dr. Ernie]] 16:59, 25 Oct 2005 (PDT)
+
-
:: [[DannyAyers]]  My point exactly, but it wouldn't be the end of the world if the prefix was there - not reallly more than aesthetics...
+
== pre 0.1 issues ==
 +
'''This section is more or less closed, as hAtom 0.1 is out the door. If there are open issues that you are championing that didn't make it into hAtom 0.1, move them up above to the hAtom 0.2 section'''
-
'''STATUS - RESOLVED'''. We're going with "entry".
+
See: [[hatom-issues-pre-0.1]]
-
:: Tantek: This is actually difficult to consider outside the following issue.  In particular, if "entry" is to serve as a potential root class name (similar to "vevent", which may be a root of an [[hcalendar|hCalendar]] event, or may be present in the context of a "vcalendar"), then we should strongly consider "uniquifying" it per our root-class-name practices. Possibilities to consider:
+
== Template ==
-
* atom-entry
+
{{issues-format}}
-
* hentry
+
-
* vjournal (from RFC 2445 and thus borrowed in effect from [[hcalendar|hCalendar]])
+
-
 
+
== See Also ==
-
 
+
-
=== Why atomfeed? ===
+
-
;class="atomfeed" (or rather, "atom-entry")
+
-
:As above on the atomprefix. But what does 'feed' mean in the context of a HTML page? Doesn't the <head> element cover the corresponding semantics?
+
-
--  [[DannyAyers]]
+
-
 
+
-
* It is possible, somewhat common, and [[blog-post-examples#Multiple_EntryGroups_on_a_page|documented]], that multiple feeds can appear on a single page, so it's insufficient to depend on the header, even though this may be the default case. You'll note that I've left out documenting a lot of concepts relating to feeds at a conceptual level, except for noting they exist because I think this is a bit of a swamp that's going to need more thinking
+
-
** I'm going to more explicitly recognize that the XHTML document ''may'' act as an implicit feed in many cases
+
-
* A Feed is a group of related Entries; what defines the relationship is entirely up to the author of the blog, except to note that if they were to place them together in the same Atom syndication feed, you'd do the same in the XHTML
+
-
::This makes sense to me, the way vcalendar is optional since vevent is usually sufficient. [[User:DrErnie|Dr. Ernie]] 16:59, 25 Oct 2005 (PDT)
+
-
::Ernie is precisely correct. The vevent/vcalendar :: entry/feed analogy is precisely correct. - Tantek
+
-
: The multi-feed point makes sense, but if this data appears on a regular HTML page the question remains, does "feed" make sense? (Maybe just naming aesthetics again) -- [[DannyAyers]]
+
-
:: I'm thinking about it more -- I think so, just to split the content of the webpage up (as opposed to blogrolls, headers, footers, etc.) -- [[User:DavidJanes|David Janes]]
+
-
:: Agreed with David. Not only does it make sense, it is a bad idea to consider renaming something like that for "aesthetics". - Tantek
+
-
 
+
-
'''STATUS - PARTIALLY RESOLVED'''. We're going with "feed" IF and when the Feed element is used. When and where Feed is used at all is still under discussion in the mailing list as of 2005-12-26.
+
-
 
+
-
: Tantek: Per the root-class-name naming practices, we should seriously consider a more "unique" name, e.g. some possibilities:
+
-
* atom-feed
+
-
* hfeed
+
-
 
+
-
=== Why rel="link" ? ===
+
-
I know this maps through to the atom name, but rel="bookmark" is the established standard for permalinks, and is included in the [http://www.w3.org/TR/html401/types.html#type-links| w3c list of rel's], so there is an Occam's Razor case for using this.
+
-
[[KevinMarks]]
+
-
* I'd like input from everyone in this -- I'm torn really. Once I knock this thing into more of a complete state, I'll throw this out onto the mailing list for discussion -- [[DavidJanes]]
+
-
* Also, "link" is horribly generic and is in fact modified through the "rel" attribute in Atom -- [[DavidJanes]]
+
-
* Agreed with what Kevin wrote.  Also, rel="link" doesn't actually make sense when you do the analysis as described in the [[rel-faq]].  The destination of the link is not really a "link" itself with respect to the current document/file. - Tantek
+
-
* OK, I'm happy with this -- [[User:DavidJanes|David Janes]]
+
-
 
+
-
'''STATUS - RESOLVED'''. We are using <code>rel="bookmark"</code>.
+
-
 
+
-
* Tantek: agreed.
+
-
 
+
-
=== title already defined by hCard ===
+
-
The title class is defined by [[hcard|hCard]] to mean "job title". Possible alternatives include (Please add to list):
+
-
 
+
-
* 'summary', as used by hReview, hCalendar, VJOURNAL
+
-
** Though I agree with the reuse, in this context, it may be confusing for those reading/familiar-with the Atom specification.  We may want to avoid the use of 'summary' entirely within hAtom. - Tantek
+
-
* 'Subject', as used by SMTP email
+
-
* 'heading'
+
-
* 'entry-title'
+
-
* 'headline'
+
-
** as this is what they are most like in blogposts [[User:Kevin Marks|Kevin Marks]]
+
-
 
+
-
=== summary already defined and used by vCalendar/iCalendar/hCalendar/hReview ===
+
-
The summary class is defined by vCalendar, iCalendar, [[hcalendar|hCalendar]], and also [[hreview|hReview]], to mean "summary or title". Possible alternatives include (add to list):
+
-
 
+
-
* description, as used by VJOURNAL. It may be possible to interpret description as text longer than summary which is about the entry content. The hierarchy of detail would be summary (atom:title) -> description (atom:summary) -> content (atom:content)
+
-
** description is used ambiguously by RSS to mean 'content' or 'summary', and by hReview and hCalendar to mean 'content'. Doing this would recreate that ambiguity needlessly, when Atom distinguishes it clearly.  [[User:Kevin Marks|Kevin Marks]] 15:51, 31 Dec 2005 (PST)
+
-
** Kevin's right, and not only that, "description" does NOT mean summary in VJOURNAL.  "description" means "full description" in vCalendar, iCalendar, [[hcalendar|hCalendar]], and also [[hreview|hReview]].  See below for where to use "description".  We must NOT use "description" to mean summary. - Tantek
+
-
 
+
-
* Depending on your interpretation, atom:summary could still be summary. Here is another option: subject (atom:title) -> summary (atom:summary) -> content (atom:content).
+
-
 
+
-
* atom:summary is described as abstract in
+
-
 
+
-
Tantek: We may want to avoid the use of 'summary' entirely within hAtom.  Here are some alternatives:
+
-
* excerpt - in practice this is what most people provide instead of full text.
+
-
** +1 Tantek
+
-
* partial-description
+
-
* abstract - Rarely do bloggers actually provide abstracts different from the full text of their posts - this is so NOT the 80% (and thus should be rejected for microformat consideration), but see [http://microformats.org/wiki/blog-post-examples#Entry_contains_summary_content_only blog-post-examples] for some examples.
+
-
* content-summary
+
-
 
+
-
=== Why content? ===
+
-
The concept behind atom:content has precedent in earlier microformats derived from the iCalendar standard as "description".
+
-
 
+
-
=== Date and time names alternatives ===
+
-
* atom:updated
+
-
** VJOURNAL LAST-MODIFIED
+
-
*** (also used by HTTP -[[User:RobertBachmann|Robert Bachmann]])
+
-
** dtstamp
+
-
** dtupdated
+
-
* atom:published
+
-
** VJOURNAL CREATED
+
-
** dtpublished
+
-
 
+
-
=== Relationship to hReview definitions needs clarification ===
+
-
hAtom will define terminology for the general act of publication that overlaps with hReview's terminology for the specific act of publishing a review of something. The following terms could be pushed back into hReview:
+
-
 
+
-
* atom:published -> hReview dtreviewed
+
-
* atom:author    -> hReview reviewer
+
-
 
+
-
"Pushed back" is the wrong direction here.
+
-
 
+
-
The right direction is "re-use" by new proposals/drafts.  If you see anything in hReview that appears to overlap this new specification, the first thing to do is to see if you can reuse those terms from hReview in this new specification, not vice versa.
+
-
 
+
-
In addition, "published" does not mean the same as "dtreviewed" (you might write a restaurant review just after you eat there, but not actually "publish" it until later).  "reviewer" is also a more precise semantic than "author", thus the two should not be collapsed.
+
-
 
+
-
- Tantek
+
-
 
+
-
== hCards ==
+
-
 
+
-
Should hCards be required for the <code>&lt;address></code> of the Entry Poster? MAY, MUST, SHOULD? Your thoughts please -- [[DavidJanes]]
+
-
 
+
-
* [[User:RobertBachmann|Robert Bachmann]]: “MUST” or at least “SHOULD” because atom:author is specified as “The "atom:author" element is a Person construct that indicates the author of the entry or feed.” and <code>&lt;address&gt;</code>’s semantics are too loose to describe [http://atompub.org/2005/08/17/draft-ietf-atompub-format-11.html#rfc.section.3.2 an Atom person construct] but using <code>&lt;addr class="vcard"&gt;</code> we would have pretty good 1:1 mappings:
+
-
** atom:name &harr; hCard’s FN
+
-
** atom:email &harr; hCard’s EMAIL
+
-
** atom:uri &harr; hCard’s URI
+
-
 
+
-
'''STATUS - OPEN'''. "MAY" is the answer.
+
-
 
+
-
Tantek: I think this should be MUST.  Atom should have referenced vCard for these semantics and made the mistake of making up their own terms.  Let's undo that mistake with hAtom.  Also, [[hreview|hReview]] 0.3 is going to make hCard a MUST for the "reviewer" property, based on experience and [[hreview-feedback|feedback]].  Thus we may want to just follow suit with hAtom as well.
+
-
 
+
-
DavidJanes: I had based the behavior on hReview 0.2. The problem is getting meaningful information into the blog templates and also I would appeal to parsimony, that is:
+
-
 
+
-
<pre><nowiki>
+
-
<div class="author">bonehead</div>
+
-
</nowiki></pre>
+
-
 
+
-
has an assumed defined mapping to
+
-
 
+
-
<pre><nowiki>
+
-
<div class="author vcard"><span class="fn">bonehead</div></div>
+
-
</nowiki></pre>
+
-
 
+
-
Since in many cases we're not going to get much more information than that, why add the verbosity? I note an analogous situation in hCard, where N.* are not required because they can be inferred algorithmicly.
+
-
 
+
-
== Comparisons ==
+
-
 
+
-
This seems precisely analogous to [http://www.meyerweb.com/eric/tools/s5/xoxo-structure-ref.html S5]:
+
-
* atomentry <-> slide
+
-
* content <-> slidecontent
+
-
* summary <-> handout
+
-
I'm all for NOT boiling the ocean, but these really seem like the same cup of tea.
+
-
 
+
-
-- [[Ernie Prabhakar]]
+
-
 
+
-
* See the [[#Purpose]] section above. Basically that drove the design decision for the naming [[User:DavidJanes|David Janes]]
+
-
 
+
-
'''STATUS - RESOLVED'''. We're sticking with atom terminology (entry, content, summary).
+
-
 
+
-
See above as David says.  The atom terminology is both problematic, and doesn't make sufficient reuse of existing microformat terminology.  As far as the analogy to S5, yes, there is an analogy, but that doesn't make them the same.  The semantics that are represented are different enough to let these evolve independently and see if content authors want them to converge or not.  Note that you can overlay hAtom and S5 in the same markup.  Anyone that is serious about converging these should *try* using both at the same time in a *real* slide presentation example and report back their experience. - Tantek
+
-
 
+
-
== Repeated Elements ==
+
-
We allow certain elements to be repeated, such as Entry Permalink, Entry Published and Entry Title, even though there can be at most one real value. We provide "disambiguation" rules for sorting out which is the real value. See [[hatom#Nesting_Rules|here]], [[hatom#Entry_Title|here]], [[hatom#Entry_Permalink|here]] and [[hatom#Entry_Published|here]].
+
-
 
+
-
Your thoughts please... -- [[User:DavidJanes|David Janes]]
+
-
 
+
-
'''STATUS - RESOLVED'''. The spec has explicit rules for disambiguating all these items if they appear multiple times.
+
-
 
+
-
== Opaqueness ==
+
-
If you have concerns about [[hatom#hAtom_Opaque|opaqueness]], that is, stopping interpretation below certain hAtom elements, raise them here.
+
-
 
+
-
=== Opaqueness of other microformat elements ===
+
-
How would we handle a case where someone wanted to provide a vcard under the class=entry element for an individual who was neither author or contributor? Consider the hypothetical case where someone wanted to list their "muse" alongside article author and contributors. If this vcard included a title it might be included accidentally as an <atom:title>.
+
-
 
+
-
To summarise,
+
-
Is it possible that other microformats found under the class=entry or class=feed elements need to be considered opaque?
+
-
 
+
-
-- BenjaminCarlyle
+
-
 
+
-
* The issue of "muse" and such is somewhat out of scope. However, I grasp your larger point -- what if we wanted to extend or compositie hAtom in the future. Given the 80-20 rule right now, my feeling is to set aside the problem and if it arises, define a <code>class="opaque"</code> element. -- [[User:DavidJanes|David Janes]]
+
-
 
+
-
See the [[mfo-examples]] document, and add further thoughts on this matter there. -- Tantek
+
-
 
+
-
=== Opaqueness of summary and content ===
+
-
What one publisher considers the entry content may differ from another publisher's point of view. Is the content simply a div that does not contain any author/updated/published metadata etc, or could some of that metadata be relevant to the content as well as the entry? Consider updated. last-modified-brainstorming introduces an idea of using <code>&lt;ins&gt;</code> and <code>&lt;del&gt;</code> elements to indicate update time. Updates are also often included in entry content with further information. This suggests to me that the line of opaqueness is blurry.
+
-
 
+
-
Perhaps content and summary should not be opaque, and instead rely on the mfo proposal to avoid parsing into microformats below the content level. This approach would allow a single div to contain both "entry" and "content" classes should all metadata be considered content by the author, or would permit any other subset of the metadata to be considered content without repeating one's self.
+
-
 
+
-
Consider also the "read more"-style blog. The following nesting of div elements is illegal under current opacity rules:
+
-
<code>&lt;div class="content">&lt;div class="summary">...</div>...</div></code>
+
-
 
+
-
A further example is provided by _fil_ on #microformats, who uses the rel-tag microformat within his atom:content to be handled as tags in his feed reader.
+
-
 
+
-
== Identification ==
+
-
The current spec under Schema:Nomenclature:Entry includes the text:
+
-
"if practical, also define id="unique-identifier" to the Entry"
+
-
What should be done with this id by parsers? How does this interact (if at all) with the interpretation of a rel=bookmark within the entry?
+
-
 
+
-
Also, how should a feed <id> element be filled out from a hAtom source document? Is a rel=bookmark at the feed level required?
+
-
 
+
-
The id elements in atom are supposed to survive all future movements of the blog t new hosting arragements and the like. Are current feed URLs or even rel=bookmarks solid enough?
+
-
 
+
-
'''STATUS - OPEN'''.
+
-
 
+
-
== HTML Title ==
+
-
Atom permits title to be either plain text or html. hAtom2Atom.xsl currently uses a plain text translation, and some feed readers seem not to handle html titles well (liferea does not normalize-whitespace, for example). Should a hAtom title element become a plain text or a html atom title? If so, should a subset of html be passed through rather than all html (including id, etc)?
+
-
 
+
-
== rel-tag ==
+
-
Should hAtom use rel-tag for atom category elements?
+
-
 
+
-
IMHO yes. -- Tantek
+
-
 
+
-
A version of this is currently implemented in hAtom2Atom.xsl, but the interpretation of rel-tag is not straightforward.
+
-
 
+
-
rel-tag uses the last path segment of a URI as its tag, for example <code>&lt;a href="http://apple.com/ipod" rel="tag">iPod</a></code>. Human-friendly content is permitted within the anchor. Atom defines three attributes on a category element. "term" is the category in use. "scheme" is a namespace for this category. "label" is a human-friendly text-only version of the category.
+
-
 
+
-
* This looks like a clear mapping to me - term is last path segment; scheme is the tagspace and label is the text within the anchor? The problem is if the scheme + tag is not a true URL  but a URI. So for your example, term is 'ipod, scheme is 'http://apple.com/' and label is iPod. [[User:Kevin Marks|Kevin Marks]] 15:03, 31 Dec 2005 (PST)
+
-
 
+
-
hAtom2Atom.xsl does not currently supply a scheme. Label is taken from the content of the anchor tag, and no special handling for content such as the title attribute of an img element is performed. Term is the portion of the href after the last slash character.
+
-
 
+
-
rel-tag permits url encoding for IRIs, as well as conversion of spaces to plus (+) characters. It is unclear whether the conversion of rel-tag data to atom:category/@term should attempt to reverse any such encoding. The handling of plus characters may be especially difficult to reverse (are the plus characters, or spaces?).
+
-
 
+
-
* They are spaces. If you want plus characters use %2B Perhaps I should add this to rel-tag. [[User:Kevin Marks|Kevin Marks]] 15:03, 31 Dec 2005 (PST)
+
-
 
+
-
== Excess disambiguation rules? ==
+
-
Disambiguation rules apply to feed and entry title, and hAtom2Atom.xsl implements these. Rules also apply to permalink, published, and updated. These are currently not implemented. If they appear multiple times in the source document they are repeated multiple times.
+
-
 
+
-
It is clear that the data relating to these fields may be repeated within a hAtom entry, however the class notation may not. Only one element need be marked with rel="bookmark". Only one need be marked published, and one updated. Should the disambiguation rules be removed and only one element be allowed for each value, or is there value to the publisher in marking different elements with the hAtom class names?
+
-
 
+
-
== Dependancies ==
+
-
=== mfo ===
+
-
Does this specification depend on acceptance of a hAtom-compatible mfo?
+
-
See [[mfo-examples]].
+
-
 
+
-
=== last-modified ===
+
-
Does this specification depend on acceptance of a hAtom-compatible last-modified?
+
-
 
+
-
== Is atom:content necessary? ==
+
-
Atom's structure is built up around separating content and other metadata. atom:updated, atom:author, and the like are separate from atom:content any may contain repeated data. Microformats are built around bringing the content and the metadata back together. Is there are genuine use case for identifying only part of the atom entry as content? Presumably the whole html entry is fit for human consumption, or it wouldn't be part of a microformatted web page. Could that whole html snippet be used as the content?
+
-
 
+
-
== Published as default value for atom:updated ==
+
-
It seems to be common practice to include an "updated" section within the main blog content to track updates to an atom:entry as they occur. It is less common to include a value for atom:published within atom:content. atom:published is usually provided by a machine, but atom:updated is often provided by a human.
+
-
 
+
-
I suggest that if a value of published exists but no value for updated exists that the required updated field be filled out from the optional published field. I think this would make changing the required value of updated easier for publishers. Also, several updates may occur to a single entry. I suggest that a disambiguation rule be applied such that the the latest timestamp of any updated field be used if several exist. The overal parser semantics would therefore be:
+
-
# If multiple updated fields exist, choose the most recent one.
+
-
# If only one updated field exists, choose that value.
+
-
# If no updated field exists but a published field exists, use the published value for atom:updated.
+
-
 
+
-
=See Also=
+
* [[hatom|hAtom]] - the draft proposal
* [[hatom|hAtom]] - the draft proposal
-
* [[hatom-issues]] - problems? complaints? ideas? Put them here
 
* [[hatom-faq]] - knowledge base
* [[hatom-faq]] - knowledge base
 +
* [[hatom-issues-resolved]]
* [[blog-post-brainstorming]]
* [[blog-post-brainstorming]]
* [[blog-post-formats]]
* [[blog-post-formats]]

Current revision

These are externally raised issues about hAtom with broadly varying degrees of merit. Thus some issues are REJECTED for a number of obvious reasons (but still documented here in case they are re-raised), and others contain longer discussions. Some issues may be ACCEPTED and perhaps cause changes or improved explanations in the spec.

IMPORTANT: Please read the hAtom FAQ and the hAtom resolved issues before giving any feedback or raising any issues as your feedback/issues may already be resolved/answered.

Submitted issues may (and probably will) be edited and rewritten for better terseness, clarity, calmness, rationality, and as neutral a point of view as possible. Write your issues well. — Tantek

Contents

closed issues

See: hatom-issues-closed

resolved issues

See: hatom-issues-resolved

issues

Please add new issues to the bottom of the list by copy and pasting the Template. Please follow-up to resolved/rejected issues with new information rather than resubmitting such issues. Duplicate issue additions will be reverted.

2010

No defined parsing rule for updated timestamps in inselements

open issue! 2010-03-20 raised by Singpolyma

  • Should we talk about parsing of <time> element?. I use this element to mark up published on my blog. It is not supported by any implementation that I know of. Should implementors be encouraged to add this? Should the spec talk about it as an alternative to datetime-design-pattern? That page currently says to check the hcal issues, but there is nothing there about it.
    • Swignition has supported this for well over a year. It's also been supported in HTML::Microformats since version 0.00_00. TobyInk 23:00, 21 March 2010 (UTC)

2009

too many required hentry properties

entry-title optionality

updated optionality

author optionality

2008

add url property to hentry

misuse of address element

2007

marking up comments

atom:category scheme

2006

Geo

Relationship of rel-bookmark to url+uid

The concept of permalink is available in hCard and hCalendar as the classes url and uid. This combination matches the permalink semantics by indicating that the url should be derefenced to find a more dynamic or up-to-date version of the content, and that that url is a stable unique id that can be used to identify the content.

hAtom 0.1 uses rel-bookmark for the permalink concept. The current state of uid-brainstorming indicates that the hCard and hCalendar permalink concept is likely to be used in subsequent microformats. It may be important to reconcile hAtom with that trajectory. Possible reconcilliations include:

1) To leave things as they are. The two permalink concepts are to be kept separate.

2) Treat the two concepts as equivalent. Allow both in hAtom, and consider allowing both in other formats. eg <a rel="bookmark" href="http://example.com/"> would fill out uid and url values if they are not supplied explicitly.

3) Choose one over the other for hAtom and perhaps for future microformats also. "url uid" allows for some greater freedom (uid can be pointed at a non-url uid), but it is unclear at this stage whether that freedom is warranted or advisable to permit.

Datetime format (atom:updated and atom:published)

Feed id (atom:id)

It is suggested the Feed permalink should be used as the feed ID, however a piece by Mark Pilgrim (http://diveintomark.org/archives/2004/05/28/howto-atom-id) makes arguments against using permalinks and in favour of Tag URIs.

Feed permalink (atom:permalink)

Feed updated (atom:updated)

Feed title (atom:title)

Feed author and Entry author (atom:author)

Entry id (atom:id)

Author

author as an hcard is too much to require

The following 3 items were extracted from the conversation starting on irc with logs available starting around here

Entry source (atom:source)

Other Questions and Issues

General comments, modeling issues, algorithm issues, should have issues, etc. go here.

Entry Updated Required? -- Blogger Issue

moved to hatom-brainstorming

'MAY have multiple Feed elements' -- details and viability of multiple feeds

moved to hatom-brainstorming

pre 0.1 issues

This section is more or less closed, as hAtom 0.1 is out the door. If there are open issues that you are championing that didn't make it into hAtom 0.1, move them up above to the hAtom 0.2 section

See: hatom-issues-pre-0.1

Template

Consider using this format (copy and paste this to the end of the list to add your issues; replace ~~~ with an external link if preferred) to report issues or feedback, so that issues can show up in hAtom subscriptions of this issues page. If open issues lack this markup, please add it.

Please post one issue per entry, to make them easier to manage. Avoid combining multiple issues into single reports, as this can confuse or muddle feedback, and puts a burden of separating the discrete issues onto someone else who 1. may not have the time, and 2. may not understand the issue in the same way as the original reporter.

<div class="hentry">
{{OpenIssue}} 
<span class="entry-summary author vcard">
 <span class="published">2011-MM-DD</span> 
 raised by <span class="fn">~~~</span>
</span>
<div class="entry-content discussion issues">
* <strong class="entry-title">«Short title of issue»</strong>. «Description of Issue»
** Follow-up comment #1
** Follow-up comment #2
</div>
</div>

See Also

hAtom issues was last modified: Sunday, August 25th, 2013

Views