stetdocdocs

Findings reference

View as markdown

stetdoc check and the receipt of an edit report findings. There are 47 codes. A violation is a departure from the schema or from a Word rule, which an edit may not add: an edit that would add one is refused as validation_failed, and a violation that the document already had is reported and not blamed on the edit. A note is legal and worth saying. A code is stable once released: new codes may be added, and existing ones are never repurposed or removed outside a major version.

Violations

CodeWhat it means
schema_wrong_rootThe root element is not the one the part must have.
schema_unexpected_childA known element that the content model does not allow in this parent.
schema_unknown_elementAn element in a namespace the schema does not know, which the part does not list in mc:Ignorable.
schema_out_of_orderAn element that is allowed in its parent but not after what precedes it, or a second copy of one that may occur once.
schema_non_canonical_orderIn a property container that the schema leaves unordered, a child is not in the order Word writes. Word reads it, and the Open XML SDK validator counts it as a schema error.
schema_missing_childThe content of an element ends before a required child.
schema_must_understandmc:MustUnderstand names a namespace that Word does not understand.
mc_prefix_undeclaredmc:Ignorable, mc:ProcessContent or mc:MustUnderstand names a prefix that no namespace declaration binds. The schema allows the attribute, and Word refuses to open the file or offers to repair it. A report lists it before every other finding, and an edit repairs it in every part it writes (decision 0014).
schema_unexpected_textCharacter data in an element that has element-only content.
schema_unknown_attributeAn attribute the schema does not define on this element.
schema_missing_attributeA required attribute is absent.
schema_invalid_attribute_valueThe value of an attribute does not satisfy its type.
text_in_deletionA w:t or w:instrText inside a w:del, where Word writes w:delText and w:delInstrText.
deltext_outside_deletionA w:delText or w:delInstrText with no w:del around it in its paragraph.
edge_space_without_preserveText that starts or ends with white space in an element that has no xml:space="preserve", so a reader may drop the space.
revision_id_duplicateTwo tracked changes of the document have the same w:id.
bookmark_id_duplicateTwo bookmarks of one part have the same w:id.
revision_nested_in_itselfA w:ins inside a w:ins, or a w:del inside a w:del, in one paragraph.
bookmark_unpairedA bookmark has a start and no end, or an end and no start.
move_range_unpairedA move range has a start and no end, or an end and no start.
move_name_unpairedA move has a source and no destination, or a destination and no source.
field_split_by_deletionA field whose begin, separator and end are not all inside a deletion or all outside one.
cell_without_final_paragraphA table cell whose last block is not a paragraph.
table_without_rowA table with no row.
row_without_cellA table row with no cell.
container_without_blockA footnote, endnote or comment that holds no paragraph or table.
empty_revisionA w:ins, w:del, w:moveFrom or w:moveTo that holds nothing.
part_without_content_typeA part that has neither an Override nor a Default for its extension in [Content_Types].xml.
relationship_target_missingAn internal relationship whose target is not a part of the package.
relationship_id_duplicateTwo relationships of one part have the same id.
comment_id_duplicateTwo comments have the same w:id.
marker_unpairedA comment range has a start and no end, or an end and no start.
marker_without_commentA comment range marker or reference whose id is no comment.
reference_missingA comment with a range and no reference run.
reference_duplicateTwo reference runs for one comment.
row_without_commentA row of a comment extension part whose paragraph id names no comment.
para_id_duplicateTwo paragraphs, at least one of them a comment paragraph, have the same w14:paraId.
thread_cycleThe parents of some comments form a loop.
durable_mismatchTwo comment parts disagree about a durable id, or a durable id is used twice.
part_unrelatedA comment extension part that the main part has no relationship to.

Notes

CodeWhat it means
empty_propertiesA w:rPr or w:pPr that holds nothing, outside the snapshot of a property change. The schema allows it, since every child is optional, so it is a note.
unanchoredA comment with no marker and no reference.
row_missingA comment with a paragraph id and no row in an extension part that exists.
para_id_missingA comment whose last paragraph has no w14:paraId, so it cannot be threaded.
para_id_rangeA w14:paraId at or above 0x80000000, which the schema forbids.
parent_missingA comment whose parent paragraph id names no comment.
part_unreadableA part that could not be read (encrypted, or stored with an unsupported method), so it was not checked.