{"action":"created","issue":{"url":"https://api.github.com/repos/godotengine/godot-docs/issues/257","repository_url":"https://api.github.com/repos/godotengine/godot-docs","labels_url":"https://api.github.com/repos/godotengine/godot-docs/issues/257/labels{/name}","comments_url":"https://api.github.com/repos/godotengine/godot-docs/issues/257/comments","events_url":"https://api.github.com/repos/godotengine/godot-docs/issues/257/events","html_url":"https://github.com/godotengine/godot-docs/issues/257","id":180536533,"number":257,"title":"Inverse Kinematics tutorial is confusing and incomplete","user":{"login":"Xananax","id":836082,"avatar_url":"https://avatars.githubusercontent.com/u/836082?v=3","gravatar_id":"","url":"https://api.github.com/users/Xananax","html_url":"https://github.com/Xananax","followers_url":"https://api.github.com/users/Xananax/followers","following_url":"https://api.github.com/users/Xananax/following{/other_user}","gists_url":"https://api.github.com/users/Xananax/gists{/gist_id}","starred_url":"https://api.github.com/users/Xananax/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Xananax/subscriptions","organizations_url":"https://api.github.com/users/Xananax/orgs","repos_url":"https://api.github.com/users/Xananax/repos","events_url":"https://api.github.com/users/Xananax/events{/privacy}","received_events_url":"https://api.github.com/users/Xananax/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2016-10-02T21:26:02Z","updated_at":"2016-10-02T23:00:47Z","closed_at":null,"body":"I've had people ask me why they aren't getting IK after implementing the functions in the [Inverse Kinematics Tutorial](http://docs.godotengine.org/en/latest/tutorials/3d/inverse_kinematics.html).\r\n\r\nAfter checking out the tutorial, I told them it has nothing to do with IK. This tutorial merely teaches how to get a parent bone.\r\n\r\nIt seems it was intended to become a full-fledged IK tutorial, since it has variables names `IK_Error` and `IK_bone_length`, but it ends abruptly after merely teaching how to loop through bones to get parents.\r\n\r\nThe link at the top (http://freespace.virgin.net/hugo.elias/models/m_ik2.htm) is also dead.\r\n\r\nI propose to either:\r\n\r\na) Rename the tutorial to \"How to find parent bones\", remove the last part about re-parenting, and making it clear that though this is useful *to implement IK*, it's not actually about IK.\r\n\r\nb) Remove the tutorial entirely\r\n\r\nc) Continue the tutorial?\r\n\r\nI realize that finding the parent bone and re-parenting are good tips, but they belong in some snippets section, not in a tutorial.\r\n\r\nThis is mildly important, imho; One of the things that drove me to Godot was to read in the doc it had IK. I didn't go into details, just read a bit and was reassured, as IK is an essential part of my project. Upon discovering it actually doesn't, I just went \"oh well\", and I'm working on my own implementation, because I like Godot for other reasons and the lack of native IK is not the end of the world; but other people might get really confused or even angry."},"comment":{"url":"https://api.github.com/repos/godotengine/godot-docs/issues/comments/251002258","html_url":"https://github.com/godotengine/godot-docs/issues/257#issuecomment-251002258","issue_url":"https://api.github.com/repos/godotengine/godot-docs/issues/257","id":251002258,"user":{"login":"Xananax","id":836082,"avatar_url":"https://avatars.githubusercontent.com/u/836082?v=3","gravatar_id":"","url":"https://api.github.com/users/Xananax","html_url":"https://github.com/Xananax","followers_url":"https://api.github.com/users/Xananax/followers","following_url":"https://api.github.com/users/Xananax/following{/other_user}","gists_url":"https://api.github.com/users/Xananax/gists{/gist_id}","starred_url":"https://api.github.com/users/Xananax/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Xananax/subscriptions","organizations_url":"https://api.github.com/users/Xananax/orgs","repos_url":"https://api.github.com/users/Xananax/repos","events_url":"https://api.github.com/users/Xananax/events{/privacy}","received_events_url":"https://api.github.com/users/Xananax/received_events","type":"User","site_admin":false},"created_at":"2016-10-02T23:00:47Z","updated_at":"2016-10-02T23:00:47Z","body":"The new image is definitely better, sure, but...\r\n\r\nMaybe I didn't explain myself properly:\r\nAs it stands, the tutorial is almost completely unrelated to IK.\r\n\r\nSo I'd think this image only makes things more confusing. It trumps people into thinking the tutorial will actually tell them how to do IK, when in fact the tutorial is about the specific Godot syntax to walk up a bone chain, and has no other information about IK, nor in general, nor in Godot (apart from a few names of concepts that one has to look up elsewhere).\r\n\r\nI don't intend to be harsh, maybe you're the original author, but I'd say, maybe at the very least add a big bold disclaimer that warns that the tutorial is unfinished?\r\n\r\nIn its current shape, the tutorial does more harm than good. I mod the unofficial Godot Discourse Server, and we've had people ask us a few times why their IK wasn't working, though they had followed the tutorial point by point. We have to then proceed to explain how the tutorial is not about IK, and direct them to other places. As I said earlier, I've been myself victim of this confusion.\r\n\r\n"}}
{"actor":{"display_login":"Xananax"}}