{"action":"created","issue":{"url":"https://api.github.com/repos/gaearon/redux/issues/140","labels_url":"https://api.github.com/repos/gaearon/redux/issues/140/labels{/name}","comments_url":"https://api.github.com/repos/gaearon/redux/issues/140/comments","events_url":"https://api.github.com/repos/gaearon/redux/issues/140/events","html_url":"https://github.com/gaearon/redux/pull/140","id":89392977,"number":140,"title":"Docs improvements","user":{"login":"acdlite","id":3624098,"avatar_url":"https://avatars.githubusercontent.com/u/3624098?v=3","gravatar_id":"","url":"https://api.github.com/users/acdlite","html_url":"https://github.com/acdlite","followers_url":"https://api.github.com/users/acdlite/followers","following_url":"https://api.github.com/users/acdlite/following{/other_user}","gists_url":"https://api.github.com/users/acdlite/gists{/gist_id}","starred_url":"https://api.github.com/users/acdlite/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/acdlite/subscriptions","organizations_url":"https://api.github.com/users/acdlite/orgs","repos_url":"https://api.github.com/users/acdlite/repos","events_url":"https://api.github.com/users/acdlite/events{/privacy}","received_events_url":"https://api.github.com/users/acdlite/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/gaearon/redux/labels/docs","name":"docs","color":"5319e7"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":10,"created_at":"2015-06-18T20:43:53Z","updated_at":"2015-06-24T07:10:32Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/gaearon/redux/pulls/140","html_url":"https://github.com/gaearon/redux/pull/140","diff_url":"https://github.com/gaearon/redux/pull/140.diff","patch_url":"https://github.com/gaearon/redux/pull/140.patch"},"body":"PR to keep track of docs improvements, as discussed in https://github.com/gaearon/redux/issues/137\r\n\r\n- [ ] Rename Stores to Reducers\r\n- [ ] Rename the “Redux instance” to Store as per https://github.com/gaearon/redux/issues/137#issuecomment-113252359\r\n- [ ] Explain that if you squint at traditional Flux Stores, you'll see Reducers trapped in them\r\n- [ ] Glossary of terms\r\n- [ ] JSDoc (and/or Flow annotations)\r\n- [ ] Design decisions\r\n- [ ] Updated README (with focus on familiar Flux concepts; keep advanced stuff in docs)\r\n- [ ] \"Getting Started\" guide\r\n- [ ] Explanation of how to subscribe to changes manually, without Provider and Connector https://github.com/gaearon/redux/issues/134#issuecomment-113272964\r\n\r\nFocus right now is to get these items completed in Markdown form. Then (or in parallel) we will turn these into a proper docs site."},"comment":{"url":"https://api.github.com/repos/gaearon/redux/issues/comments/114756152","html_url":"https://github.com/gaearon/redux/pull/140#issuecomment-114756152","issue_url":"https://api.github.com/repos/gaearon/redux/issues/140","id":114756152,"user":{"login":"vladap","id":4263458,"avatar_url":"https://avatars.githubusercontent.com/u/4263458?v=3","gravatar_id":"","url":"https://api.github.com/users/vladap","html_url":"https://github.com/vladap","followers_url":"https://api.github.com/users/vladap/followers","following_url":"https://api.github.com/users/vladap/following{/other_user}","gists_url":"https://api.github.com/users/vladap/gists{/gist_id}","starred_url":"https://api.github.com/users/vladap/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vladap/subscriptions","organizations_url":"https://api.github.com/users/vladap/orgs","repos_url":"https://api.github.com/users/vladap/repos","events_url":"https://api.github.com/users/vladap/events{/privacy}","received_events_url":"https://api.github.com/users/vladap/received_events","type":"User","site_admin":false},"created_at":"2015-06-24T07:10:32Z","updated_at":"2015-06-24T07:10:32Z","body":"Here are my thoughts on documenting important differences between ActionCreators vs. Actions which everybody trying to use flux/redux should be clear about. The differences are subtle but important. Feel free to rephrase it or drop it all together, I just want to log what I think can help to new users.\r\n\r\nActionCreator tells what should happen while Action tells what happened. ActionCreator can be understood as a Command while an Action is an event (like mouseClicked in DOM). If you come from an analytical database modeling background you would call Action a Fact (and they would be stored in a fact table in a star schema).\r\n\r\nActionCreators can be processed concurrently (async) and emit Actions when appropriate. Actions are processed synchronously, they can be logged to create synchronous log which can be potentially replayed (if there is such a facility).\r\n\r\nAs a sidenote, because ActionCreator term is long, people tend to shortcut it to just Action term in a general discussion (or even in a API) and freely swap them, which might be confusing at times. It could be better to have Commands and Events, or Actions (as a synonym to commands) and Events (some other eventsourcing/commandsourcing systems use these terms). But I understand the desire to stick to the original Flux terminology. For me, used to another background, it was quite confusing to decode Flux at first even there was no new concept for me."}}