dotnet / dotnet/docfx

[Feature Request] Support `Overwrite Files` feature for `"outputFormat": "apiPage"`

Open
#9,984 0 comments 1 reaction 0 assignees View on GitHub
Dominant language
C#
Stars
4.4k
Forks
890
Avg merge
2h 9m
Merged PRs (30d)
11

Description

**Is your feature request related to a problem? Please describe.**

When using `"outputFormat": "apiPage"` option.

It seems [Overwrite Files](https://dotnet.github.io/docfx/tutorial/intro_overwrite_files.html) is not applied.
(I've confirmed this behaviors with `docfx/samples/seed/specs` overwrite files)

And `Overwrite File` seems not works when using `"outputFormat": "markdown"` and overwrite for `conceptual` document by `uid`.

**Describe the solution you'd like**
This issue is created as reminder.

If there are users who want to using `Overwrite File` features for `ApiPage`.
It might be better to support similar `Overwrite File` feature for `apiPage`/`markdown` output format.

**Describe alternatives you've considered**
Add supported document types to [Overwrite Files document](https://dotnet.github.io/docfx/tutorial/intro_overwrite_files.html) page.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.