{"action":"created","issue":{"url":"https://api.github.com/repos/premake/premake-core/issues/178","labels_url":"https://api.github.com/repos/premake/premake-core/issues/178/labels{/name}","comments_url":"https://api.github.com/repos/premake/premake-core/issues/178/comments","events_url":"https://api.github.com/repos/premake/premake-core/issues/178/events","html_url":"https://github.com/premake/premake-core/issues/178","id":97763932,"number":178,"title":"Changing public reception of Premake","user":{"login":"Lusito","id":1135267,"avatar_url":"https://avatars.githubusercontent.com/u/1135267?v=3","gravatar_id":"","url":"https://api.github.com/users/Lusito","html_url":"https://github.com/Lusito","followers_url":"https://api.github.com/users/Lusito/followers","following_url":"https://api.github.com/users/Lusito/following{/other_user}","gists_url":"https://api.github.com/users/Lusito/gists{/gist_id}","starred_url":"https://api.github.com/users/Lusito/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Lusito/subscriptions","organizations_url":"https://api.github.com/users/Lusito/orgs","repos_url":"https://api.github.com/users/Lusito/repos","events_url":"https://api.github.com/users/Lusito/events{/privacy}","received_events_url":"https://api.github.com/users/Lusito/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":19,"created_at":"2015-07-28T17:56:34Z","updated_at":"2015-08-08T20:31:22Z","closed_at":null,"body":"I guess it's painfully obvious, but that's more reason to start changing something.\r\nPremake does not present itself very well to the world.\r\nGoogling premake brings me to (In order):\r\n- The github page\r\n- The sourceforge page\r\n- industrious one page\r\n- bitbucket page\r\n\r\nThat is 4 different pages!\r\n\r\nIt's good that github is the first entry, since it's the latest one, but why are the other ones still active ?\r\n- Sourceforge shows content from version 3.7 and that version 4.0 is released, but the old documentation remains.\r\n- Bitbucket shows that content has moved to gibhub, but:\r\n  - It's not highlighted red or anything.. anyone used to skipping headers and introductions will not read it.\r\n  - There is still documentation about premake5.\r\n\r\nGoogling Premake5 will bring you to bitbucket first!\r\nI think that the old places are still up & running is the reason why google lists them as high as they are right now.\r\n\r\nAlmost all discussion entries about premake show something like \"not updated since 2010\".\r\nThis is probably another symptom of the above.\r\n\r\nLooking at the main page (Github), it shows 5.0 alpha and 4.4 beta. People don't like alpha or beta. They like stable releases. 5.0 has been alpha since at least 2013.\r\n\r\nMy suggestions:\r\n- Remove all content from the old pages, replace it with a link to the new page. This should help prevent search engines from indexing old pages as high as currently.\r\n- If possible, add an automatic redirect to the new page. \r\n- Remove the forum from http://industriousone.com/forums/premake. The content there is so old there is probably no use for keeping it.\r\n- If the google group is the currently active forum, then by all means put a link to it on the github page and readme.md.\r\n- Put a link to the github wiki into the readme.md on github. Few projects use the wiki on github, so if you don't point people to it, they won't try to look for it.\r\n- Add a short & nice description of the project into the readme.md.\r\n- And most of all, cut features as much as needed to get 5.0 golden.\r\n   - Don't make this into Duke Nukem Forever.\r\n\r\nA nice example of a helpful readme.md is [Ashley](https://github.com/libgdx/ashley/):\r\n- Appealing logo\r\n- Short but informative description\r\n- Every link you need to get started using it\r\n- Information about the community and how to contribute\r\n\r\nI really like premake, but it saddens me to see it not using its full potential."},"comment":{"url":"https://api.github.com/repos/premake/premake-core/issues/comments/129042876","html_url":"https://github.com/premake/premake-core/issues/178#issuecomment-129042876","issue_url":"https://api.github.com/repos/premake/premake-core/issues/178","id":129042876,"user":{"login":"starkos","id":249247,"avatar_url":"https://avatars.githubusercontent.com/u/249247?v=3","gravatar_id":"","url":"https://api.github.com/users/starkos","html_url":"https://github.com/starkos","followers_url":"https://api.github.com/users/starkos/followers","following_url":"https://api.github.com/users/starkos/following{/other_user}","gists_url":"https://api.github.com/users/starkos/gists{/gist_id}","starred_url":"https://api.github.com/users/starkos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/starkos/subscriptions","organizations_url":"https://api.github.com/users/starkos/orgs","repos_url":"https://api.github.com/users/starkos/repos","events_url":"https://api.github.com/users/starkos/events{/privacy}","received_events_url":"https://api.github.com/users/starkos/received_events","type":"User","site_admin":false},"created_at":"2015-08-08T20:31:22Z","updated_at":"2015-08-08T20:31:22Z","body":"Nice, thanks! Do you need anything else from me?"}}