version - Revision history

Aaronpk: Replace with {{DISPLAYTITLE:}}

2020-07-18T16:34:49Z

Replace <entry-title> with {{DISPLAYTITLE:}}

← Older revision		Revision as of 16:34, 18 July 2020
Line 1:		Line 1:
	~~<entry-title>~~version~~</entry-title>~~		{{DISPLAYTITLE:version}}

	Per the microformats [[process]], this is a page for researching and brainstorming a [[rel]] value for linking to a previous [[version]] of a page.		Per the microformats [[process]], this is a page for researching and brainstorming a [[rel]] value for linking to a previous [[version]] of a page.

BigBlueHat: Add thoughts and links to RFC5829

2016-10-06T13:24:17Z

Add thoughts and links to RFC5829

← Older revision		Revision as of 13:24, 6 October 2016
Line 24:		Line 24:
	* rel=version		* rel=version
	** +1 [[User:Tantek\|Tantek]] : this feels like the most human-author-friendly term of these.		** +1 [[User:Tantek\|Tantek]] : this feels like the most human-author-friendly term of these.
			** -1 [[User:BigBlueHat\|BigBlueHat]] : lacks directionality; fine for the "this thing is a version case...maybe"
	* rel=revision		* rel=revision
	** Mediawiki uses the term "revision" in the UI when you're viewing a previous version of a page.		** Mediawiki uses the term "revision" in the UI when you're viewing a previous version of a page.
	** "revision" has a developer feel to it, common terminology in revision control systems (naturally) like git etc.		** "revision" has a developer feel to it, common terminology in revision control systems (naturally) like git etc.
			** -1 [[User:BigBlueHat\|BigBlueHat]] : same issue as above; also revision !== version
	* rel=older		* rel=older
	** -1 [[User:Tantek\|Tantek]]: "older" feels wrong as a noun.		** -1 [[User:Tantek\|Tantek]]: "older" feels wrong as a noun.
Line 38:		Line 40:
	* rel=latest		* rel=latest
	** might mean a specific link to the latest version, though W3C specs use the phrase "Latest Version" to label the link to the always current URL - [[User:Tantek\|Tantek]]		** might mean a specific link to the latest version, though W3C specs use the phrase "Latest Version" to label the link to the always current URL - [[User:Tantek\|Tantek]]
			* rel=latest-version
			** from [https://tools.ietf.org/html/rfc5829#page-2\|RFC 5829]
			* rel=predecessor-version
			** from [https://tools.ietf.org/html/rfc5829#page-2\|RFC 5829]
			* rel=successor-version
			** from [https://tools.ietf.org/html/rfc5829#page-2\|RFC 5829]
	* ...		* ...

	==== history ====		==== history ====
	MediaWiki pages don't link directly to previous versions, rather they link to a "History" page which then links to previous versions.		MediaWiki pages don't link directly to previous versions, rather they link to a "History" page which then links to previous versions.
Line 44:		Line 53:
	We can at least consider brainstorming a link rel to that history page accordingly:		We can at least consider brainstorming a link rel to that history page accordingly:
	* rel=history - on a link from a page to a document that lists history of that page, perhaps linking to previous versions.		* rel=history - on a link from a page to a document that lists history of that page, perhaps linking to previous versions.
			* rel=version-history
			** from [https://tools.ietf.org/html/rfc5829#page-2\|RFC 5829]

	Is there any meaningful way to markup (rel value) links from a history page to the page itself or from a history page to previous versions of the page?		Is there any meaningful way to markup (rel value) links from a history page to the page itself or from a history page to previous versions of the page?

Tantek: /* related work */ subhead

2013-04-01T21:36:08Z

related work: subhead

← Older revision		Revision as of 21:36, 1 April 2013
Line 48:		Line 48:

	== related work ==		== related work ==
			=== canonical ===
	You can already use:		You can already use:
	* [[rel-canonical]] to link to the canonical version of a page. But this doesn't mean it's a different version, if anything, it may be the exact same content just at a shorter or more reliable/official URL.		* [[rel-canonical]] to link to the canonical version of a page. But this doesn't mean it's a different version, if anything, it may be the exact same content just at a shorter or more reliable/official URL.

Tantek: /* what about rel prev */ different content vs. same content but with small changes

2013-04-01T21:30:58Z

what about rel prev: different content vs. same content but with small changes

← Older revision		Revision as of 21:30, 1 April 2013
Line 56:		Line 56:

	[[rel-prev\|rel=prev]] (and [[rel-next\|next]]) are for sequential navigation/pagination, not historical revisions.		[[rel-prev\|rel=prev]] (and [[rel-next\|next]]) are for sequential navigation/pagination, not historical revisions.

			Sequential navigation/pagination and historical versions are totally different, both in how the content works, and in usage.

			In pagination, each of the pages has ''different content'' and is a sequence like a list, or a series of chapters.

			In historical revisions, each page (typically) has mostly the ''same content'' with just a few changes/differences between versions.

	Pagination is often used as an alternative to delivering the content as a whole, e.g. news articles. Whereas you never see previous historical versions all appended together as if that's "the whole thing".		Pagination is often used as an alternative to delivering the content as a whole, e.g. news articles. Whereas you never see previous historical versions all appended together as if that's "the whole thing".

Tantek: pagination vs. whole

2013-04-01T21:28:12Z

pagination vs. whole

← Older revision		Revision as of 21:28, 1 April 2013
Line 56:		Line 56:

	[[rel-prev\|rel=prev]] (and [[rel-next\|next]]) are for sequential navigation/pagination, not historical revisions.		[[rel-prev\|rel=prev]] (and [[rel-next\|next]]) are for sequential navigation/pagination, not historical revisions.

			Pagination is often used as an alternative to delivering the content as a whole, e.g. news articles. Whereas you never see previous historical versions all appended together as if that's "the whole thing".

	== see also ==		== see also ==
	* [[existing-rel-values]]		* [[existing-rel-values]]
	* [[rel-canonical]]		* [[rel-canonical]]

Tantek: add history, faq, rel prev

2013-04-01T21:18:55Z

add history, faq, rel prev

← Older revision		Revision as of 21:18, 1 April 2013
Line 22:		Line 22:
	== brainstorming ==		== brainstorming ==
	Several rel values are being considered for linking from a document to a previous version of that document.		Several rel values are being considered for linking from a document to a previous version of that document.
	* rel=older
	** -1 [[User:Tantek\|Tantek]]: "older" feels wrong as a noun.
	* rel=version		* rel=version
	** +1 [[User:Tantek\|Tantek]] : this feels like the most human-author-friendly term of these.		** +1 [[User:Tantek\|Tantek]] : this feels like the most human-author-friendly term of these.
Line 29:		Line 27:
	** Mediawiki uses the term "revision" in the UI when you're viewing a previous version of a page.		** Mediawiki uses the term "revision" in the UI when you're viewing a previous version of a page.
	** "revision" has a developer feel to it, common terminology in revision control systems (naturally) like git etc.		** "revision" has a developer feel to it, common terminology in revision control systems (naturally) like git etc.
			* rel=older
			** -1 [[User:Tantek\|Tantek]]: "older" feels wrong as a noun.
	* ...		* ...

	=== related brainstorming ===		=== related brainstorming ===
			==== current ====
	A related use case is to be able to find the current version of document when looking at an older version. For this, the following rel values are being considered:		A related use case is to be able to find the current version of document when looking at an older version. For this, the following rel values are being considered:
	* rel=current		* rel=current
Line 38:		Line 39:
	** might mean a specific link to the latest version, though W3C specs use the phrase "Latest Version" to label the link to the always current URL - [[User:Tantek\|Tantek]]		** might mean a specific link to the latest version, though W3C specs use the phrase "Latest Version" to label the link to the always current URL - [[User:Tantek\|Tantek]]
	* ...		* ...
			==== history ====
			MediaWiki pages don't link directly to previous versions, rather they link to a "History" page which then links to previous versions.

			We can at least consider brainstorming a link rel to that history page accordingly:
			* rel=history - on a link from a page to a document that lists history of that page, perhaps linking to previous versions.

			Is there any meaningful way to markup (rel value) links from a history page to the page itself or from a history page to previous versions of the page?

	== related work ==		== related work ==
	You can already use:		You can already use:
	* [[rel-canonical]] to link to the canonical version of a page. But this doesn't mean it's a different version, if anything, it may be the exact same content just at a shorter or more reliable/official URL.		* [[rel-canonical]] to link to the canonical version of a page. But this doesn't mean it's a different version, if anything, it may be the exact same content just at a shorter or more reliable/official URL.

			== FAQ ==
			=== what about rel prev ===
			What about rel="prev" (or "previous")?

			[[rel-prev\|rel=prev]] (and [[rel-next\|next]]) are for sequential navigation/pagination, not historical revisions.

	== see also ==		== see also ==
	* [[existing-rel-values]]		* [[existing-rel-values]]
	* [[rel-canonical]]		* [[rel-canonical]]

Tantek: comments on version, revision, current, latest

2013-04-01T21:11:53Z

comments on version, revision, current, latest

← Older revision		Revision as of 21:11, 1 April 2013
Line 25:		Line 25:
	** -1 [[User:Tantek\|Tantek]]: "older" feels wrong as a noun.		** -1 [[User:Tantek\|Tantek]]: "older" feels wrong as a noun.
	* rel=version		* rel=version
			** +1 [[User:Tantek\|Tantek]] : this feels like the most human-author-friendly term of these.
	* rel=revision		* rel=revision
			** Mediawiki uses the term "revision" in the UI when you're viewing a previous version of a page.
			** "revision" has a developer feel to it, common terminology in revision control systems (naturally) like git etc.
	* ...		* ...

Line 31:		Line 34:
	A related use case is to be able to find the current version of document when looking at an older version. For this, the following rel values are being considered:		A related use case is to be able to find the current version of document when looking at an older version. For this, the following rel values are being considered:
	* rel=current		* rel=current
			** seems like a link to something that is always current, not that it happens to be current right now. - [[User:Tantek\|Tantek]]
	* rel=latest		* rel=latest
			** might mean a specific link to the latest version, though W3C specs use the phrase "Latest Version" to label the link to the always current URL - [[User:Tantek\|Tantek]]
	* ...		* ...

Tantek: version brainstorming, let's do this

2013-04-01T21:06:08Z

version brainstorming, let's do this

New page

<entry-title>version</entry-title>

Per the microformats [[process]], this is a page for researching and brainstorming a [[rel]] value for linking to a previous [[version]] of a page.

== use case ==
To be able to discover previous versions of a document automatically from a document.

== examples ==
* W3C. Nearly every W3C specification has a link in the header to the "Previous Version".
* ...

== formats ==
=== revision control systems ===
Revision control systems (RCS) like:
* CVS
* SVN
* mercurial (hg)
* git

All have ways of representing previous versions of a document.

== brainstorming ==
Several rel values are being considered for linking from a document to a previous version of that document.
* rel=older
** -1 [[User:Tantek|Tantek]]: "older" feels wrong as a noun.
* rel=version
* rel=revision
* ...

=== related brainstorming ===
A related use case is to be able to find the current version of document when looking at an older version. For this, the following rel values are being considered:
* rel=current
* rel=latest
* ...

== related work ==
You can already use:
* [[rel-canonical]] to link to the canonical version of a page. But this doesn't mean it's a different version, if anything, it may be the exact same content just at a shorter or more reliable/official URL.

== see also ==
* [[existing-rel-values]]
* [[rel-canonical]]