{"action":"created","issue":{"url":"https://api.github.com/repos/jekyll/jekyll/issues/3595","labels_url":"https://api.github.com/repos/jekyll/jekyll/issues/3595/labels{/name}","comments_url":"https://api.github.com/repos/jekyll/jekyll/issues/3595/comments","events_url":"https://api.github.com/repos/jekyll/jekyll/issues/3595/events","html_url":"https://github.com/jekyll/jekyll/issues/3595","id":63046978,"number":3595,"title":"Add README guidance for `.jekyll-metadata`","user":{"login":"fj","id":57813,"avatar_url":"https://avatars.githubusercontent.com/u/57813?v=3","gravatar_id":"","url":"https://api.github.com/users/fj","html_url":"https://github.com/fj","followers_url":"https://api.github.com/users/fj/followers","following_url":"https://api.github.com/users/fj/following{/other_user}","gists_url":"https://api.github.com/users/fj/gists{/gist_id}","starred_url":"https://api.github.com/users/fj/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fj/subscriptions","organizations_url":"https://api.github.com/users/fj/orgs","repos_url":"https://api.github.com/users/fj/repos","events_url":"https://api.github.com/users/fj/events{/privacy}","received_events_url":"https://api.github.com/users/fj/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/jekyll/jekyll/labels/Documentation","name":"Documentation","color":"bfdadc"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":18,"created_at":"2015-03-19T17:26:59Z","updated_at":"2015-11-04T23:41:31Z","closed_at":"2015-03-21T00:46:52Z","body":"As of 3.0.0 Jekyll now generates a `.jekyll-metadata` file, but it's not clear if this is something that should be in source control or not. It's not in the [official site](https://github.com/jekyll/jekyll/tree/master/site), for example. Can a section be added to the README explaining this?"},"comment":{"url":"https://api.github.com/repos/jekyll/jekyll/issues/comments/153905840","html_url":"https://github.com/jekyll/jekyll/issues/3595#issuecomment-153905840","issue_url":"https://api.github.com/repos/jekyll/jekyll/issues/3595","id":153905840,"user":{"login":"envygeeks","id":99763,"avatar_url":"https://avatars.githubusercontent.com/u/99763?v=3","gravatar_id":"","url":"https://api.github.com/users/envygeeks","html_url":"https://github.com/envygeeks","followers_url":"https://api.github.com/users/envygeeks/followers","following_url":"https://api.github.com/users/envygeeks/following{/other_user}","gists_url":"https://api.github.com/users/envygeeks/gists{/gist_id}","starred_url":"https://api.github.com/users/envygeeks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/envygeeks/subscriptions","organizations_url":"https://api.github.com/users/envygeeks/orgs","repos_url":"https://api.github.com/users/envygeeks/repos","events_url":"https://api.github.com/users/envygeeks/events{/privacy}","received_events_url":"https://api.github.com/users/envygeeks/received_events","type":"User","site_admin":false},"created_at":"2015-11-04T23:41:31Z","updated_at":"2015-11-04T23:41:31Z","body":"To add guidance @tomjohnson1492 whether you add `.jekyll-metadata` is really a personal choice since it's a marshaled data file with things like last modification time, if you use a build server to build your data it might actually be useful to commit it.  On our build servers we actually do save that file if the user does not provide it because it speeds up TTL for them."}}