The current text:

References of type canonical may include a version, in order be precise about which version of the resource is being referred to. To do this, append the version to the reference with a '|' like this:

<valueSet value="http://hl7.org/fhir/ValueSet/my-valueset|0.8"/>

This is a version specific reference to a value set. Note that this refers to the ValueSet.version not the ValueSet.meta.versionId. Searching for this on a FHIR server would look like this:

GET fhir/ValueSet?url=http://hl7.org/fhir/ValueSet/my-valueset&version=0.8

Is quite confusing. My reading would indicate that the second example matches the ValueSet.meta.versionId, which is incorrect.

Recommend changing to:

References of type canonical may include a version, in order be precise about which version of the resource is being referred to. To do this, append the version to the reference with a '|' like this:

<valueSet value="http://hl7.org/fhir/ValueSet/my-valueset|0.8"/>

Resolving the pipe ('|') syntax (above) is done in the same way as using a GET with the version parameter:

GET fhir/ValueSet?url=http://hl7.org/fhir/ValueSet/my-valueset&version=0.8

Both of these examples are references to a specific version of value set. Note that this refers to the ValueSet.version not the ValueSet.meta.versionId.