{"action":"created","issue":{"url":"https://api.github.com/repos/Qucs/qucs/issues/340","labels_url":"https://api.github.com/repos/Qucs/qucs/issues/340/labels{/name}","comments_url":"https://api.github.com/repos/Qucs/qucs/issues/340/comments","events_url":"https://api.github.com/repos/Qucs/qucs/issues/340/events","html_url":"https://github.com/Qucs/qucs/pull/340","id":101080873,"number":340,"title":"A \"What's new\" window (WIP)","user":{"login":"in3otd","id":9018179,"avatar_url":"https://avatars.githubusercontent.com/u/9018179?v=3","gravatar_id":"","url":"https://api.github.com/users/in3otd","html_url":"https://github.com/in3otd","followers_url":"https://api.github.com/users/in3otd/followers","following_url":"https://api.github.com/users/in3otd/following{/other_user}","gists_url":"https://api.github.com/users/in3otd/gists{/gist_id}","starred_url":"https://api.github.com/users/in3otd/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/in3otd/subscriptions","organizations_url":"https://api.github.com/users/in3otd/orgs","repos_url":"https://api.github.com/users/in3otd/repos","events_url":"https://api.github.com/users/in3otd/events{/privacy}","received_events_url":"https://api.github.com/users/in3otd/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":5,"created_at":"2015-08-14T18:59:48Z","updated_at":"2015-08-18T16:24:17Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/Qucs/qucs/pulls/340","html_url":"https://github.com/Qucs/qucs/pull/340","diff_url":"https://github.com/Qucs/qucs/pull/340.diff","patch_url":"https://github.com/Qucs/qucs/pull/340.patch"},"body":"here is a customary \"What's new\" window that might be useful to inform the (new) users about the most important changes.\r\nAs usual, the window is automatically shown at startup (if the current Qucs version is newer than the last version used) and the user can choose not to see the \"What's new\" window again. It remains available in the 'Help' menu anyway.\r\nI label this as a Work In Progress since\r\n- the actual text to show still needs to be written (not an easy task...)\r\n- I think that the window appearance and design could be improved\r\n\r\n![qucs_whatsnew](https://cloud.githubusercontent.com/assets/9018179/9280932/ff79422c-42c1-11e5-9f2a-9d38b2a28246.png)\r\n\r\nand, as usual, while writing this I (had to) change other stuff; I added a `SemVer` class to handle the comparison between version strings, since there was nothing already that could tell \"is version 0.0.18 earlier than 0.0.19 or not?\".\r\nThe existing `misc::checkVersion()` handled only one kind of comparison ('greather than') and also did not handle major versions (important if we will ever release `Qucs 1.0.0`, one day :grin:)"},"comment":{"url":"https://api.github.com/repos/Qucs/qucs/issues/comments/132265877","html_url":"https://github.com/Qucs/qucs/pull/340#issuecomment-132265877","issue_url":"https://api.github.com/repos/Qucs/qucs/issues/340","id":132265877,"user":{"login":"in3otd","id":9018179,"avatar_url":"https://avatars.githubusercontent.com/u/9018179?v=3","gravatar_id":"","url":"https://api.github.com/users/in3otd","html_url":"https://github.com/in3otd","followers_url":"https://api.github.com/users/in3otd/followers","following_url":"https://api.github.com/users/in3otd/following{/other_user}","gists_url":"https://api.github.com/users/in3otd/gists{/gist_id}","starred_url":"https://api.github.com/users/in3otd/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/in3otd/subscriptions","organizations_url":"https://api.github.com/users/in3otd/orgs","repos_url":"https://api.github.com/users/in3otd/repos","events_url":"https://api.github.com/users/in3otd/events{/privacy}","received_events_url":"https://api.github.com/users/in3otd/received_events","type":"User","site_admin":false},"created_at":"2015-08-18T16:24:17Z","updated_at":"2015-08-18T16:24:17Z","body":"yep, not sure the \"must declare a public API\" makes sense for (every) application. But `VersionTriplet` sounds  good enough and does not suggest compliance with Semantic Versioning...\r\n\r\nGenerating the \"What's new\" from a `NEWS` file makes sense of course, I thought to use directly that file at the beginning, but then wanted to be able to use some nice formatting with html and did not want to link an external library just to parse one markdown file. Can maybe just translate the markdown to html when compiling/preparing for a release.  \r\nNote that I put the `whatsnew.html` in `qucs/qucs-help/docs/en/` thinking that it could be translated in other languages. Not sure how often that will happen (but looking at the more or less regular contributors we should be able to have at least 4 other languages, besides English), can likely be elsewhere if we do not plan to have it translated.\r\n"}}