Skip to content

Commit

Permalink
docs: update markdig multiple overwrite sections
Browse files Browse the repository at this point in the history
  • Loading branch information
yufeih committed Mar 7, 2023
1 parent f3bdb0b commit 50e87b1
Showing 1 changed file with 0 additions and 4 deletions.
4 changes: 0 additions & 4 deletions docs/tutorial/intro_overwrite_files.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,10 +58,6 @@ footer: <p>Footer for <code>microsoft.com/docfx/Contacts</code></p>
`uid` for an *Overwrite Model* stands for the Unique IDentifier of the *Model* it will overwrite. So it is allowed to have multiple *Overwrite Section*s with YAML Header containing the same `uid`. For one *Overwrite File*, the latter *Overwrite Section* overwrites the former one with the same `uid`. For different *Overwrite File*s, the order of overwrite is **Undetermined**. So it is suggested to have *Overwrite Sections* with the same `uid` in the same *Overwrite File*.

> [!NOTE]
>
> Multiple *Overwrite Section*s in one file doesn't work in markdig markdown engine. You should remove `"markdownEngineName": "markdig",` from `docfx.json` to support this feature.

When processing *Conceptual File*s and *Metadata File*s, *Overwrite Model*s with the same `uid` are applied to the processed *Model*s. Different *Model*s have different overwrite principles, [Overwrite principles](#overwrite-principles) section describes the them in detail.

Apply *Overwrite File*s
Expand Down

0 comments on commit 50e87b1

Please sign in to comment.