{"action":"opened","issue":{"url":"https://api.github.com/repos/cakephp/docs/issues/2344","labels_url":"https://api.github.com/repos/cakephp/docs/issues/2344/labels{/name}","comments_url":"https://api.github.com/repos/cakephp/docs/issues/2344/comments","events_url":"https://api.github.com/repos/cakephp/docs/issues/2344/events","html_url":"https://github.com/cakephp/docs/issues/2344","id":56123289,"number":2344,"title":"3.0: Explain difference of FormHelper::submit() and ::button","user":{"login":"nrother","id":6770775,"avatar_url":"https://avatars.githubusercontent.com/u/6770775?v=3","gravatar_id":"","url":"https://api.github.com/users/nrother","html_url":"https://github.com/nrother","followers_url":"https://api.github.com/users/nrother/followers","following_url":"https://api.github.com/users/nrother/following{/other_user}","gists_url":"https://api.github.com/users/nrother/gists{/gist_id}","starred_url":"https://api.github.com/users/nrother/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nrother/subscriptions","organizations_url":"https://api.github.com/users/nrother/orgs","repos_url":"https://api.github.com/users/nrother/repos","events_url":"https://api.github.com/users/nrother/events{/privacy}","received_events_url":"https://api.github.com/users/nrother/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-01-31T12:23:23Z","updated_at":"2015-01-31T12:23:23Z","closed_at":null,"body":"I find [the doc](http://book.cakephp.org/3.0/en/views/helpers/form.html#Cake\\View\\Helper\\FormHelper::submit) about `button()` and `submit()` very confusing.\r\n\r\nAfter reading I had the imagination that `submit()` will forward all requests to `button()`, but enables me to specify an image, which button seems not to allow.\r\n\r\nAfter looking in the code I saw that `submit()` does *not* call `button()` but contains a variety of other code.\r\n\r\nSome where in the docs I found a warning always to end my Forms with `submit()`, but then I saw that `button()` will also generate a submit button.\r\n\r\nIMHO the doc (and maybe the API?) should be much clearer here. What's the difference and when to use which method?"}}