Goal 5 states that a document's identity survives a round trip only through the lossless pair #150
@@ -43,7 +43,8 @@ In priority order.
|
|||||||
rendered document sees or follows, its text, images and link targets. Content the document only
|
rendered document sees or follows, its text, images and link targets. Content the document only
|
||||||
references is marked where it stood, by a note that reads as the converter's and names what was
|
references is marked where it stood, by a note that reads as the converter's and names what was
|
||||||
left out. The lossy pair creates and exports; it never saves back over the document it read —
|
left out. The lossy pair creates and exports; it never saves back over the document it read —
|
||||||
identity (task, mention, media ids) lives only in the lossless pair.
|
a document's identity (task, mention, media ids) survives only the lossless pair, and the task
|
||||||
|
ids `plainMarkdownToAdf` mints are new ones.
|
||||||
6. **What happens is what the audience expects.** Where the goals leave a choice, a conversion
|
6. **What happens is what the audience expects.** Where the goals leave a choice, a conversion
|
||||||
takes the one its audience would predict, reading the input as written.
|
takes the one its audience would predict, reading the input as written.
|
||||||
7. **Failures are values.** Nothing throws, and `code` is a closed list — as much a contract as
|
7. **Failures are values.** Nothing throws, and `code` is a closed list — as much a contract as
|
||||||
|
|||||||
Reference in New Issue
Block a user