Is there any demo of using overwriting with docfx v3?

[gggdttt]

Operating System: Windows

DocFX Version Used: 3

Template used: dynamic 365 business center

Steps to Reproduce:

1. Follow all the steps shown in https://dotnet.github.io/docfx/tutorial/intro_overwrite_files.html
2. Tried both docfx.json and docfx.yml file. All the overwriting .md file is put under folder content, with uid specified.

globalMetadata:
  titleSuffix: My Awesome Website
overwrite: content/**.md
exclude: 
- ./template/**
template: template

3. The page can not show overwriting content correctly.

Expected Behavior:

Actual Behavior:

[gggdttt]

I am not sure if the guidance is only for docfx v2? Because I tried docfx2 and it worked. But when I changed to docfx3, it fails to render.

[KalleOlaviNiemitalo]

According to https://github.com/dotnet/docfx/issues/4586#issuecomment-494291244, DocFX v3 supports only "Markdown fragments" files, not YAML overwrite files.

[gggdttt]

@KalleOlaviNiemitalo Thank you so much!

[gggdttt]

Hi, sorry to reopen this issue. Now I am following markdown fragment, but I don't know why it does not work completely. Now my file is:

• override
  • test.md
• ref
  • String.yml

The content of test.md is :

# `System.String`
```  yaml
author: rpetrusha
ms.author: ronpet
manager: wpickett
name: this is a test
```
## `examples`
Fragment version

And my String.yml is

#YamlMime:NetEnum
uid: System.String
name: String
examples: Origin verison.

After follow the guidance, I don't know why the Origin version is not replaced with fragment version . The content of string.html does not change. Should I change some config in docfx.yml?

[gggdttt]

My config is:

template: ./template/
exclude: ./template/**
globalMetadata:
  titleSuffix: My Awesome Websites

which is generated by docfx init.

[yufeih]

Markdown fragment is also not supported in docfx v3.