{"action":"created","issue":{"url":"https://api.github.com/repos/fastlane/fastlane/issues/4691","repository_url":"https://api.github.com/repos/fastlane/fastlane","labels_url":"https://api.github.com/repos/fastlane/fastlane/issues/4691/labels{/name}","comments_url":"https://api.github.com/repos/fastlane/fastlane/issues/4691/comments","events_url":"https://api.github.com/repos/fastlane/fastlane/issues/4691/events","html_url":"https://github.com/fastlane/fastlane/issues/4691","id":155174930,"number":4691,"title":"Gymfile documentation is very confusing","user":{"login":"ChristopherDrum","id":320377,"avatar_url":"https://avatars.githubusercontent.com/u/320377?v=3","gravatar_id":"","url":"https://api.github.com/users/ChristopherDrum","html_url":"https://github.com/ChristopherDrum","followers_url":"https://api.github.com/users/ChristopherDrum/followers","following_url":"https://api.github.com/users/ChristopherDrum/following{/other_user}","gists_url":"https://api.github.com/users/ChristopherDrum/gists{/gist_id}","starred_url":"https://api.github.com/users/ChristopherDrum/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ChristopherDrum/subscriptions","organizations_url":"https://api.github.com/users/ChristopherDrum/orgs","repos_url":"https://api.github.com/users/ChristopherDrum/repos","events_url":"https://api.github.com/users/ChristopherDrum/events{/privacy}","received_events_url":"https://api.github.com/users/ChristopherDrum/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/fastlane/fastlane/labels/gym","name":"gym","color":"d4c5f9"},{"url":"https://api.github.com/repos/fastlane/fastlane/labels/question","name":"question","color":"cc317c"},{"url":"https://api.github.com/repos/fastlane/fastlane/labels/todo-docs","name":"todo-docs","color":"c5def5"}],"state":"open","locked":false,"assignee":{"login":"vpolouchkine","id":915660,"avatar_url":"https://avatars.githubusercontent.com/u/915660?v=3","gravatar_id":"","url":"https://api.github.com/users/vpolouchkine","html_url":"https://github.com/vpolouchkine","followers_url":"https://api.github.com/users/vpolouchkine/followers","following_url":"https://api.github.com/users/vpolouchkine/following{/other_user}","gists_url":"https://api.github.com/users/vpolouchkine/gists{/gist_id}","starred_url":"https://api.github.com/users/vpolouchkine/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vpolouchkine/subscriptions","organizations_url":"https://api.github.com/users/vpolouchkine/orgs","repos_url":"https://api.github.com/users/vpolouchkine/repos","events_url":"https://api.github.com/users/vpolouchkine/events{/privacy}","received_events_url":"https://api.github.com/users/vpolouchkine/received_events","type":"User","site_admin":false},"milestone":null,"comments":3,"created_at":"2016-05-17T04:32:02Z","updated_at":"2016-05-18T05:14:14Z","closed_at":null,"body":"### Issue Description\r\nThe documentation about how to use a gymfile is deeply lacking. Creating a new gymfile via `gym init` created a file that seemingly only allows for the definition of a single plist file attached to a single scheme. As well, the link embedded in the default file points to the old documentation page.\r\n\r\n1. The gymfile allows for a \"scheme\" parameter, but does this equate to the Xcode scheme that we would pass to the gym command directly (i.e. when not using a gymfile)? Or is this adding a gymfile \"scheme\" that should then be referenced in my fastfile when running gym?\r\n2. How is the file organized to allow for alternate parameters for different build schemes? As a simple example, setting different export_options on my ad-hoc development build vs. my app store release build does not seem to be possible.\r\n3. Can export_options be passed directly to the gym command in my fastfile without the use of a gymfile? It doesn't seem possible, even though gym itself clearly understands that parameter when passed via the gymfile. \r\n4. Why would I want a gymfile that just points to a plist file, rather than including that information in the gymfile itself? What is the benefit of each usage of gym?\r\n  * Calling gym and passing parameters directly in the fastfile\r\n  * Using gym to call its gymfile\r\n  * Using gym to call a gymfile which simply loads a plist\r\n5. The documentation says, \"Since Xcode 7, gym is using new Xcode API which allows us to specify export options using plist file. By default gym creates this file for you\". Where is this file? Is it temporary? Am I supposed to capture it somehow and modify for future purposes? `gym init` seemed not to create such a thing. Do I need a separate plist for each Xcode build scheme, or does one plist handle them all?"},"comment":{"url":"https://api.github.com/repos/fastlane/fastlane/issues/comments/219927149","html_url":"https://github.com/fastlane/fastlane/issues/4691#issuecomment-219927149","issue_url":"https://api.github.com/repos/fastlane/fastlane/issues/4691","id":219927149,"user":{"login":"KrauseFx","id":869950,"avatar_url":"https://avatars.githubusercontent.com/u/869950?v=3","gravatar_id":"","url":"https://api.github.com/users/KrauseFx","html_url":"https://github.com/KrauseFx","followers_url":"https://api.github.com/users/KrauseFx/followers","following_url":"https://api.github.com/users/KrauseFx/following{/other_user}","gists_url":"https://api.github.com/users/KrauseFx/gists{/gist_id}","starred_url":"https://api.github.com/users/KrauseFx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/KrauseFx/subscriptions","organizations_url":"https://api.github.com/users/KrauseFx/orgs","repos_url":"https://api.github.com/users/KrauseFx/repos","events_url":"https://api.github.com/users/KrauseFx/events{/privacy}","received_events_url":"https://api.github.com/users/KrauseFx/received_events","type":"User","site_admin":false},"created_at":"2016-05-18T05:14:14Z","updated_at":"2016-05-18T05:14:14Z","body":"Thank you so much for your feedback @ChristopherDrum, we should definitely improve the onboarding experience and documentation for the `Gymfile`"}}