Skip to content

docs: explain how to mark generated files with linguist-generated - #99

Open
akashchamp wants to merge 1 commit into
nedbat:mainfrom
akashchamp:docs-linguist-generated
Open

akashchamp wants to merge 1 commit into
nedbat:mainfrom
akashchamp:docs-linguist-generated

Conversation

@akashchamp

Copy link
Copy Markdown

Adds a short "Generated files on GitHub" section to the running docs showing how to mark whole cog-generated files with linguist-generated=true in .gitattributes, so GitHub collapses them in diffs. It also notes that this only works for whole files, not for cog output inside a hand-written file. Changelog entry added.

Closes #53

Checked: sphinx -W -b html docs builds with only the existing html_static_path '_static' does not exist warning (same on main), and cog --check on docs/running.rst passes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add linguist-generated=true to the docs

1 participant