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

Comments

Projects
None yet
3 participants
@sergeybykov
Member

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

This comment has been minimized.

Show comment
Hide comment
@superyyrrzz

superyyrrzz Feb 3, 2017

Collaborator

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

Collaborator

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