{"action":"created","issue":{"url":"https://api.github.com/repos/creesch/reddit-moderator-toolbox/issues/447","labels_url":"https://api.github.com/repos/creesch/reddit-moderator-toolbox/issues/447/labels{/name}","comments_url":"https://api.github.com/repos/creesch/reddit-moderator-toolbox/issues/447/comments","events_url":"https://api.github.com/repos/creesch/reddit-moderator-toolbox/issues/447/events","html_url":"https://github.com/creesch/reddit-moderator-toolbox/issues/447","id":54532368,"number":447,"title":"rewriting the notification module settings, reorganising the module and adding additional instructions","user":{"login":"hermithome","id":7720458,"avatar_url":"https://avatars.githubusercontent.com/u/7720458?v=3","gravatar_id":"","url":"https://api.github.com/users/hermithome","html_url":"https://github.com/hermithome","followers_url":"https://api.github.com/users/hermithome/followers","following_url":"https://api.github.com/users/hermithome/following{/other_user}","gists_url":"https://api.github.com/users/hermithome/gists{/gist_id}","starred_url":"https://api.github.com/users/hermithome/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hermithome/subscriptions","organizations_url":"https://api.github.com/users/hermithome/orgs","repos_url":"https://api.github.com/users/hermithome/repos","events_url":"https://api.github.com/users/hermithome/events{/privacy}","received_events_url":"https://api.github.com/users/hermithome/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-01-16T02:16:47Z","updated_at":"2015-01-16T16:20:50Z","closed_at":null,"body":"With the help of psdtwk, I've taken a stab at rewriting the notification module settings so that they clearly state what they do.\r\n\r\nHere's my initial stab at what it should look like. I've reorganised the module by diving it into two sections: counter settings and notification settings. Both sections include a short para at the top, explaining how they work, and introducing the terminology used in the settings. And I created three sub-sections for notification settings into three sections: personal messages, modmail and queues. Visually I imagined a little header and the section being indented.\r\n\r\nI've also reworded most of the individual setting options. I tried to strike a balance between brevity and clarity. \r\n\r\nI forked the page so I could rearrange stuff and add in language where I think it should go, just to give a good sense of the changes I want to see. It is totally non-functional code though, as I just added text in wherever I thought it should go, I didn't even comment it out. Hopefully though, it gives a good sense of the changes I think should be made for user understandability.\r\n\r\nhttps://github.com/hermithome/reddit-moderator-toolbox/blob/patch-1/modules/notifier.js"},"comment":{"url":"https://api.github.com/repos/creesch/reddit-moderator-toolbox/issues/comments/70278233","html_url":"https://github.com/creesch/reddit-moderator-toolbox/issues/447#issuecomment-70278233","issue_url":"https://api.github.com/repos/creesch/reddit-moderator-toolbox/issues/447","id":70278233,"user":{"login":"creesch","id":2502190,"avatar_url":"https://avatars.githubusercontent.com/u/2502190?v=3","gravatar_id":"","url":"https://api.github.com/users/creesch","html_url":"https://github.com/creesch","followers_url":"https://api.github.com/users/creesch/followers","following_url":"https://api.github.com/users/creesch/following{/other_user}","gists_url":"https://api.github.com/users/creesch/gists{/gist_id}","starred_url":"https://api.github.com/users/creesch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/creesch/subscriptions","organizations_url":"https://api.github.com/users/creesch/orgs","repos_url":"https://api.github.com/users/creesch/repos","events_url":"https://api.github.com/users/creesch/events{/privacy}","received_events_url":"https://api.github.com/users/creesch/received_events","type":"User","site_admin":false},"created_at":"2015-01-16T16:20:50Z","updated_at":"2015-01-16T16:20:50Z","body":"As I said earlier this is no functional code. I am not sure we want to include that much text on setting pages themselves. A lot of people when looking at settings will tl;dr if there is a lot of text on the assumption that it must be complicated stuff. \r\n\r\nSo personally I'd like to keep documentation and functionality seperated in that regard. \r\n\r\nThat doesn't mean we can't look at the current labels and clarify those a bit. However [this for example](https://github.com/hermithome/reddit-moderator-toolbox/blob/patch-1/modules/notifier.js#L111) is way too much text. \r\n\r\n"}}