Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Is there a way to suppress the `generator` meta tag? #1251

Closed
sergeybykov opened this issue Jan 27, 2017 · 1 comment
Closed

Is there a way to suppress the `generator` meta tag? #1251

sergeybykov opened this issue Jan 27, 2017 · 1 comment

Comments

@sergeybykov
Copy link
Member

@sergeybykov sergeybykov commented Jan 27, 2017

Title

Every update of DocFx tooling causes changes in every single generated html file because of the meta name="generator" content="docfx 2.10.2.0 tag being updated. Is there a way to suppress this tag, so that rebuilding docs with a new version of DocFx wouldn't make changes to every single generated html file?

Functional impact

When committing docs generated with a new version of DocFx we have to either manually excluded files with no meaningful changes (error prone) or include all files, which adds too much noise to the change history.

Minimal repro steps

Build docs with DocFx 2.10.1.0.
Change a single line in the source file.
Rebuild docs with DocFx 2.10.2.0
See every single generated html file changed.

Expected result

A flag of config option to suppress insertion of meta name="generator" content="docfx x.y.z.a` tag to generated html files.

Actual result

Generator tag with a DocFx version in every single html file.

@superyyrrzz
Copy link
Contributor

@superyyrrzz superyyrrzz commented Feb 3, 2017

Hi @sergeybykov , you can overwrite it in docfx.json's global metadata like "globalMetadata": {"_docfxVersion": "x.y.z.a"}. But as affected by a bug, this option can only take effect from DocFX's next release v2.12

@chenkennt chenkennt closed this Apr 13, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
3 participants
You can’t perform that action at this time.