{"action":"created","issue":{"url":"https://api.github.com/repos/dotnet/docfx/issues/164","repository_url":"https://api.github.com/repos/dotnet/docfx","labels_url":"https://api.github.com/repos/dotnet/docfx/issues/164/labels{/name}","comments_url":"https://api.github.com/repos/dotnet/docfx/issues/164/comments","events_url":"https://api.github.com/repos/dotnet/docfx/issues/164/events","html_url":"https://github.com/dotnet/docfx/issues/164","id":134332142,"number":164,"title":"Metadata being left behind","user":{"login":"wekempf","id":3430823,"avatar_url":"https://avatars.githubusercontent.com/u/3430823?v=3","gravatar_id":"","url":"https://api.github.com/users/wekempf","html_url":"https://github.com/wekempf","followers_url":"https://api.github.com/users/wekempf/followers","following_url":"https://api.github.com/users/wekempf/following{/other_user}","gists_url":"https://api.github.com/users/wekempf/gists{/gist_id}","starred_url":"https://api.github.com/users/wekempf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wekempf/subscriptions","organizations_url":"https://api.github.com/users/wekempf/orgs","repos_url":"https://api.github.com/users/wekempf/repos","events_url":"https://api.github.com/users/wekempf/events{/privacy}","received_events_url":"https://api.github.com/users/wekempf/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-02-17T16:38:47Z","updated_at":"2016-03-18T13:51:13Z","closed_at":null,"body":"I'm a little confused by the metadata Yaml files generated into the api folder. First, this is generated code, for the most part, so I thought I could add this folder to .gitignore and/or delete it safely. However, at least index.md seems like it's necessary to keep in source control. Is there anything else in this directory that's not generated?\r\n\r\nThe real issue here, though, is that if you remove a class from the project, for instance, and regenerate the metadata the old YML file for that class isn't removed. That won't be as big of an issue if I can figure out what I can exclude from source control here, but it still seems like a bad thing.\r\n\r\nBTW, what would a good .gitignore list be for docfx?"},"comment":{"url":"https://api.github.com/repos/dotnet/docfx/issues/comments/198369834","html_url":"https://github.com/dotnet/docfx/issues/164#issuecomment-198369834","issue_url":"https://api.github.com/repos/dotnet/docfx/issues/164","id":198369834,"user":{"login":"wekempf","id":3430823,"avatar_url":"https://avatars.githubusercontent.com/u/3430823?v=3","gravatar_id":"","url":"https://api.github.com/users/wekempf","html_url":"https://github.com/wekempf","followers_url":"https://api.github.com/users/wekempf/followers","following_url":"https://api.github.com/users/wekempf/following{/other_user}","gists_url":"https://api.github.com/users/wekempf/gists{/gist_id}","starred_url":"https://api.github.com/users/wekempf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wekempf/subscriptions","organizations_url":"https://api.github.com/users/wekempf/orgs","repos_url":"https://api.github.com/users/wekempf/repos","events_url":"https://api.github.com/users/wekempf/events{/privacy}","received_events_url":"https://api.github.com/users/wekempf/received_events","type":"User","site_admin":false},"created_at":"2016-03-18T13:51:13Z","updated_at":"2016-03-18T13:51:13Z","body":"That's great, but this doesn't address the issue with generated metadata being left behind, at least not directly. With the .gitignore information it's possible to manually \"clean\" the metadata before generating it, which works but isn't a very friendly way of managing this. It would be much better for metadata generation to remove any no longer valid metadata files."}}