Thread overview | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
May 13, 2019 D Language Specification | ||||
---|---|---|---|---|
| ||||
Hi, I am interested in working on this in my spare time. How do I get started - i.e. what is the process for submitting changes to the spec? Regards Dibyendu |
May 13, 2019 Re: D Language Specification | ||||
---|---|---|---|---|
| ||||
Posted in reply to Dibyendu Majumdar | On Monday, 13 May 2019 at 15:46:36 UTC, Dibyendu Majumdar wrote: > Hi, > > I am interested in working on this in my spare time. How do I get started - i.e. what is the process for submitting changes to the spec? > > Regards > Dibyendu Do you mean language changes or specification text improvements? The spec itself is here: https://github.com/dlang/dlang.org/tree/master/spec For language changes see https://github.com/dlang/DIPs/blob/master/PROCEDURE.md |
May 13, 2019 Re: D Language Specification | ||||
---|---|---|---|---|
| ||||
Posted in reply to Eugene Wissner | On Monday, 13 May 2019 at 15:51:22 UTC, Eugene Wissner wrote: > On Monday, 13 May 2019 at 15:46:36 UTC, Dibyendu Majumdar wrote: >> I am interested in working on this in my spare time. How do I get started - i.e. what is the process for submitting changes to the spec? > > Do you mean language changes or specification text improvements? > Specification text improvements. > The spec itself is here: https://github.com/dlang/dlang.org/tree/master/spec Thank you - so changes should be submitted via pull requests? Regards |
May 13, 2019 Re: D Language Specification | ||||
---|---|---|---|---|
| ||||
Posted in reply to Dibyendu Majumdar | On Monday, 13 May 2019 at 15:55:15 UTC, Dibyendu Majumdar wrote:
> On Monday, 13 May 2019 at 15:51:22 UTC, Eugene Wissner wrote:
>> On Monday, 13 May 2019 at 15:46:36 UTC, Dibyendu Majumdar wrote:
>>> I am interested in working on this in my spare time. How do I get started - i.e. what is the process for submitting changes to the spec?
>>
>> Do you mean language changes or specification text improvements?
>>
>
> Specification text improvements.
>
>> The spec itself is here: https://github.com/dlang/dlang.org/tree/master/spec
>
> Thank you - so changes should be submitted via pull requests?
>
> Regards
yes, I think it is sufficient.
|
May 14, 2019 Re: D Language Specification | ||||
---|---|---|---|---|
| ||||
Posted in reply to Eugene Wissner | On Monday, 13 May 2019 at 15:59:34 UTC, Eugene Wissner wrote:
>>> The spec itself is here: https://github.com/dlang/dlang.org/tree/master/spec
>>
>> Thank you - so changes should be submitted via pull requests?
>>
> yes, I think it is sufficient.
Apologies if this question has been asked before. Is there a reason why the spec cannot be written in something like RestructuredText or Markdown? I ask because github natively supports these formats, which makes it easier / more productive.
Thanks and Regards
Dibyendu
|
May 14, 2019 Re: D Language Specification | ||||
---|---|---|---|---|
| ||||
Posted in reply to Dibyendu Majumdar Attachments:
| On Tue, 2019-05-14 at 01:20 +0000, Dibyendu Majumdar via Digitalmars-d wrote: > On Monday, 13 May 2019 at 15:59:34 UTC, Eugene Wissner wrote: > > > > The spec itself is here: https://github.com/dlang/dlang.org/tree/master/spec > > > > > > Thank you - so changes should be submitted via pull requests? > > > > > yes, I think it is sufficient. > > Apologies if this question has been asked before. Is there a reason why the spec cannot be written in something like RestructuredText or Markdown? I ask because github natively supports these formats, which makes it easier / more productive. Or better still AsciiDoc. I know choice of source format creates quasi-religious warfare and/or bikeshedding, but AsciiDoc (with the AsciiDoctor toolchain) is superior on all but one metric. That metric being mindshare: Markdown seems all pervasive, but as soon as you want to do anything that is not trivial it fails. > Thanks and Regards > Dibyendu -- Russel. =========================================== Dr Russel Winder t: +44 20 7585 2200 41 Buckmaster Road m: +44 7770 465 077 London SW11 1EN, UK w: www.russel.org.uk |
May 14, 2019 Re: D Language Specification | ||||
---|---|---|---|---|
| ||||
Posted in reply to Dibyendu Majumdar | On Tuesday, 14 May 2019 at 01:20:01 UTC, Dibyendu Majumdar wrote: > On Monday, 13 May 2019 at 15:59:34 UTC, Eugene Wissner wrote: >>>> The spec itself is here: https://github.com/dlang/dlang.org/tree/master/spec >>> >>> Thank you - so changes should be submitted via pull requests? >>> >> yes, I think it is sufficient. > > Apologies if this question has been asked before. Is there a reason why the spec cannot be written in something like RestructuredText or Markdown? I ask because github natively supports these formats, which makes it easier / more productive. > > Thanks and Regards > Dibyendu All of dlang.org (as far as I can see) is written in ddoc, the D embedded documentation format https://dlang.org/spec/ddoc.html. It produces output in various formats, not just HTML. If you don’t want to set up your local build of the website, then you can still make the pull requests and inspect the results as built by the testing bots that will be accessible from the PR page. While you are iterating, you may want to prepend your PR title with “[WIP]”. Bastiaan. |
May 14, 2019 Re: D Language Specification | ||||
---|---|---|---|---|
| ||||
Posted in reply to Bastiaan Veelo | On Tuesday, 14 May 2019 at 07:47:36 UTC, Bastiaan Veelo wrote: > While you are iterating, you may want to prepend your PR title with “[WIP]”. While the "[WIP]" prefix still works, the preferred method is to create a draft PR. See https://github.blog/2019-02-14-introducing-draft-pull-requests/ Mike |
May 14, 2019 Re: D Language Specification | ||||
---|---|---|---|---|
| ||||
Posted in reply to Mike Franklin | On Tuesday, 14 May 2019 at 07:49:58 UTC, Mike Franklin wrote:
> While the "[WIP]" prefix still works, the preferred method is to create a draft PR. See https://github.blog/2019-02-14-introducing-draft-pull-requests/
>
> Mike
Cool!
|
May 14, 2019 Re: D Language Specification | ||||
---|---|---|---|---|
| ||||
Posted in reply to Dibyendu Majumdar | On Monday, 13 May 2019 at 15:46:36 UTC, Dibyendu Majumdar wrote: > Hi, > > I am interested in working on this in my spare time. How do I get started - i.e. what is the process for submitting changes to the spec? > > Regards > Dibyendu Thank you. It looks like you have watched the AGM and are acting upon an important point from it. If not, please watch https://youtu.be/cpTAtiboIDs?t=6324. Bastiaan. |
Copyright © 1999-2021 by the D Language Foundation