digitalmars.D - Better README.md for dlang.org
- Andrei Alexandrescu (5/5) Jan 19 2015 https://github.com/D-Programming-Language/dlang.org/blob/master/README.m...
- ponce (4/9) Jan 19 2015 Windows makefile does not generate cssmenu.css, other than that
- MattCoder (3/5) Jan 19 2015 Please let's bury those 2 altogether with IE9. :)
- "Ola Fosheim =?UTF-8?B?R3LDuHN0YWQi?= (3/7) Jan 20 2015 Might as well kill IE10 too then.
- Vladimir Panteleev (2/4) Jan 19 2015 https://github.com/D-Programming-Language/dlang.org/pull/788
- Mike (6/10) Jan 19 2015 https://issues.dlang.org/show_bug.cgi?id=13436 can probably be
- Jonathan M Davis via Digitalmars-d (4/8) Jan 20 2015 The windows makefile suffers from using an inferior version of make to
- Andrej Mitrovic via Digitalmars-d (5/9) Jan 20 2015 Btw, apparently we can use a contributing file that automatically
- Rikki Cattermole (4/15) Jan 20 2015 Ugh supposedly github supports a bunch of emoji and sounds:
- Mike (8/12) Jan 20 2015 That could be useful, but I don't think the build instructions
- Andrei Alexandrescu (2/13) Jan 20 2015 Shall we move README.md to CONTRIBUTING.md then? -- Andrei
- H. S. Teoh via Digitalmars-d (6/22) Jan 20 2015 We should have both. The current README.md should explain what the repo
- Andrei Alexandrescu (4/23) Jan 20 2015 Yah, you're right. By the time someone has made a pull request, they're
- H. S. Teoh via Digitalmars-d (6/32) Jan 20 2015 Looks like README.md already has info about contributing?
- Andrei Alexandrescu (9/15) Jan 20 2015 There's a flow about things:
- Vladimir Panteleev (9/33) Jan 20 2015 Case in point, this occurred on IRC today:
- H. S. Teoh via Digitalmars-d (7/15) Jan 20 2015 https://github.com/D-Programming-Language/dmd/pull/4323
https://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot. Andrei
Jan 19 2015
On Monday, 19 January 2015 at 23:14:11 UTC, Andrei Alexandrescu wrote:https://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot. AndreiWindows makefile does not generate cssmenu.css, other than that it seems workable.
Jan 19 2015
On Monday, 19 January 2015 at 23:04:40 UTC, ponce wrote:Does IE7/IE8 are to be supported or IE9+ is the target? (IE9+ is more pleasant).Please let's bury those 2 altogether with IE9. :) Matheus.
Jan 19 2015
"Ola Fosheim =?UTF-8?B?R3LDuHN0YWQi?= On Tuesday, 20 January 2015 at 00:40:23 UTC, MattCoder wrote:On Monday, 19 January 2015 at 23:04:40 UTC, ponce wrote:Might as well kill IE10 too then. http://caniuse.com/usage_table.phpDoes IE7/IE8 are to be supported or IE9+ is the target? (IE9+ is more pleasant).Please let's bury those 2 altogether with IE9. :)
Jan 20 2015
On Tuesday, 20 January 2015 at 00:10:04 UTC, ponce wrote:Windows makefile does not generate cssmenu.css, other than that it seems workable.https://github.com/D-Programming-Language/dlang.org/pull/788
Jan 19 2015
On Monday, 19 January 2015 at 23:14:11 UTC, Andrei Alexandrescu wrote:https://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot.https://issues.dlang.org/show_bug.cgi?id=13436 can probably be closed. I added a few additional suggestions to that issue, but I'm joyed just to something that works. Thank you. Mike
Jan 19 2015
On Monday, January 19, 2015 15:14:16 Andrei Alexandrescu via Digitalmars-d wrote:https://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot.The windows makefile suffers from using an inferior version of make to what's on the POSIX systems. - Jonathan M Davis
Jan 20 2015
On 1/20/15, Andrei Alexandrescu via Digitalmars-d <digitalmars-d puremagic.com> wrote:https://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot.Btw, apparently we can use a contributing file that automatically shows up when people make pull requests: https://help.github.com/articles/setting-guidelines-for-repository-contributors/
Jan 20 2015
On 20/01/2015 11:19 p.m., Andrej Mitrovic via Digitalmars-d wrote:On 1/20/15, Andrei Alexandrescu via Digitalmars-d <digitalmars-d puremagic.com> wrote:Ugh supposedly github supports a bunch of emoji and sounds: http://www.emoji-cheat-sheet.com/ Well I learnt something today.https://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot.Btw, apparently we can use a contributing file that automatically shows up when people make pull requests: https://help.github.com/articles/setting-guidelines-for-repository-contributors/
Jan 20 2015
On Tuesday, 20 January 2015 at 10:19:44 UTC, Andrej Mitrovic via Digitalmars-d wrote:Btw, apparently we can use a contributing file that automatically shows up when people make pull requests: https://help.github.com/articles/setting-guidelines-for-repository-contributors/That could be useful, but I don't think the build instructions should go there, because contributors won't even make it to the submitting a pull request if they can't build and verify their changes. I think the build instructions should stay in the readme. That's where I go to get started. Mike
Jan 20 2015
On 1/20/15 2:19 AM, Andrej Mitrovic via Digitalmars-d wrote:On 1/20/15, Andrei Alexandrescu via Digitalmars-d <digitalmars-d puremagic.com> wrote:Shall we move README.md to CONTRIBUTING.md then? -- Andreihttps://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot.Btw, apparently we can use a contributing file that automatically shows up when people make pull requests: https://help.github.com/articles/setting-guidelines-for-repository-contributors/
Jan 20 2015
On Tue, Jan 20, 2015 at 08:24:29AM -0800, Andrei Alexandrescu via Digitalmars-d wrote:On 1/20/15 2:19 AM, Andrej Mitrovic via Digitalmars-d wrote:We should have both. The current README.md should explain what the repo is all about. Details on contributing should go in CONTRIBUTING.md. T -- It is the quality rather than the quantity that matters. -- Lucius Annaeus SenecaOn 1/20/15, Andrei Alexandrescu via Digitalmars-d <digitalmars-d puremagic.com> wrote:Shall we move README.md to CONTRIBUTING.md then? -- Andreihttps://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot.Btw, apparently we can use a contributing file that automatically shows up when people make pull requests: https://help.github.com/articles/setting-guidelines-for-repository-contributors/
Jan 20 2015
On 1/20/15 8:32 AM, H. S. Teoh via Digitalmars-d wrote:On Tue, Jan 20, 2015 at 08:24:29AM -0800, Andrei Alexandrescu via Digitalmars-d wrote:Yah, you're right. By the time someone has made a pull request, they're already hooked in :o). Could you please draft a brief CONTRIBUTING.md? -- AndreiOn 1/20/15 2:19 AM, Andrej Mitrovic via Digitalmars-d wrote:We should have both. The current README.md should explain what the repo is all about. Details on contributing should go in CONTRIBUTING.md.On 1/20/15, Andrei Alexandrescu via Digitalmars-d <digitalmars-d puremagic.com> wrote:Shall we move README.md to CONTRIBUTING.md then? -- Andreihttps://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot.Btw, apparently we can use a contributing file that automatically shows up when people make pull requests: https://help.github.com/articles/setting-guidelines-for-repository-contributors/
Jan 20 2015
On Tue, Jan 20, 2015 at 08:40:04AM -0800, Andrei Alexandrescu via Digitalmars-d wrote:On 1/20/15 8:32 AM, H. S. Teoh via Digitalmars-d wrote:Looks like README.md already has info about contributing? https://github.com/D-Programming-Language/dlang.org/pull/803 T -- Let X be the set not defined by this sentence...On Tue, Jan 20, 2015 at 08:24:29AM -0800, Andrei Alexandrescu via Digitalmars-d wrote:Yah, you're right. By the time someone has made a pull request, they're already hooked in :o). Could you please draft a brief CONTRIBUTING.md? -- AndreiOn 1/20/15 2:19 AM, Andrej Mitrovic via Digitalmars-d wrote:We should have both. The current README.md should explain what the repo is all about. Details on contributing should go in CONTRIBUTING.md.On 1/20/15, Andrei Alexandrescu via Digitalmars-d <digitalmars-d puremagic.com> wrote:Shall we move README.md to CONTRIBUTING.md then? -- Andreihttps://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot.Btw, apparently we can use a contributing file that automatically shows up when people make pull requests: https://help.github.com/articles/setting-guidelines-for-repository-contributors/
Jan 20 2015
On 1/20/15 9:10 AM, H. S. Teoh via Digitalmars-d wrote:On Tue, Jan 20, 2015 at 08:40:04AM -0800, Andrei Alexandrescu via Digitalmars-d wrote:There's a flow about things: 1. README.md is for folks who are considering contributing so it gets them started. 2. CONTRIBUTE.md is for folks who've already gone through the steps and are ready to issue a pull request. So that would be more of tactical stuff: preferred style, prefer fewer changes per pull, few commits, ping in the forums for feedback and more discussion, etc. etc. AndreiYah, you're right. By the time someone has made a pull request, they're already hooked in :o). Could you please draft a brief CONTRIBUTING.md? -- AndreiLooks like README.md already has info about contributing? https://github.com/D-Programming-Language/dlang.org/pull/803
Jan 20 2015
On Tuesday, 20 January 2015 at 16:34:33 UTC, H. S. Teoh via Digitalmars-d wrote:On Tue, Jan 20, 2015 at 08:24:29AM -0800, Andrei Alexandrescu via Digitalmars-d wrote:Case in point, this occurred on IRC today: [2015-01-20 21:25:09] [dgiagio] Where can I open an issue for druntime? It's GitHub repo doesn't support opening issues There should probably be a link to Bugzilla in every repo's README.md. So many projects on GitHub use GitHub issues (including e.g. Rust) that some people might head directly there to file an issue.On 1/20/15 2:19 AM, Andrej Mitrovic via Digitalmars-d wrote:We should have both. The current README.md should explain what the repo is all about. Details on contributing should go in CONTRIBUTING.md.On 1/20/15, Andrei Alexandrescu via Digitalmars-d <digitalmars-d puremagic.com> wrote:Shall we move README.md to CONTRIBUTING.md then? -- Andreihttps://github.com/D-Programming-Language/dlang.org/blob/master/README.md 1. If instructions don't work for you, reply here. 2. Additions for Windows would be welcome. FWIW I think the Windows makefile suffers from a bit of bitrot.Btw, apparently we can use a contributing file that automatically shows up when people make pull requests: https://help.github.com/articles/setting-guidelines-for-repository-contributors/
Jan 20 2015
On Tue, Jan 20, 2015 at 09:36:01PM +0000, Vladimir Panteleev via Digitalmars-d wrote: [...]Case in point, this occurred on IRC today: [2015-01-20 21:25:09] [dgiagio] Where can I open an issue for druntime? It's GitHub repo doesn't support opening issues There should probably be a link to Bugzilla in every repo's README.md. So many projects on GitHub use GitHub issues (including e.g. Rust) that some people might head directly there to file an issue.https://github.com/D-Programming-Language/dmd/pull/4323 https://github.com/D-Programming-Language/druntime/pull/1112 T -- Give me some fresh salted fish, please.
Jan 20 2015