On Friday, 17 April 2015 at 13:20:19 UTC, albatroz wrote:
> On Thursday, 16 April 2015 at 17:33:09 UTC, Andrei Alexandrescu wrote:
>> On 4/16/15 8:47 AM, bachmeier wrote:
>> Please let me know if https://github.com/D-Programming-Language/dlang.org/blob/master/CONTRIBUTING.md floats your boat. We should make it more visible, too. -- Andrei
>
> Can the document be improved with additional info:
> Were are the files to be changed?
> How to generate new documentation files after making a change?
>
> Thanks

That helps (and yes it should be more visible, at least on the wiki where it talks about contributing).

What would be most helpful would be an example of fixing the documentation of a Phobos function. That would show how to do it as well as the kinds of changes to make.

On Friday, 17 April 2015 at 02:11:29 UTC, Walter Bright wrote:
> On 4/16/2015 8:47 AM, bachmeier wrote:
>> In my case I don't know where to start. I'll leave the Phobos and compiler code
>> to the experts, but I'm sure I can help with documentation. On my own small
>> projects, I can clone a repo, make a small change, and create a pull request. If
>> it were that simple, I'd already be contributing to the documentation, because
>> the things that need improvement aren't hard to find.
>>
>> Unfortunately I have no idea how to get started.
>
>
> http://www.digitalmars.com/d/archives/digitalmars/D/Phobos_Documentation_-_call_to_action_258777.html

That's a good thread. Unfortunately it existed during my spring break. There should be a link to it on the wiki section I quoted. I will do that as my first contribution.

On Friday, 17 April 2015 at 19:41:01 UTC, bachmeier wrote:
> On Friday, 17 April 2015 at 02:11:29 UTC, Walter Bright wrote:
>> On 4/16/2015 8:47 AM, bachmeier wrote:
>>> In my case I don't know where to start. I'll leave the Phobos and compiler code
>>> to the experts, but I'm sure I can help with documentation. On my own small
>>> projects, I can clone a repo, make a small change, and create a pull request. If
>>> it were that simple, I'd already be contributing to the documentation, because
>>> the things that need improvement aren't hard to find.
>>>
>>> Unfortunately I have no idea how to get started.
>>
>>
>> http://www.digitalmars.com/d/archives/digitalmars/D/Phobos_Documentation_-_call_to_action_258777.html
>
> That's a good thread. Unfortunately it existed during my spring break. There should be a link to it on the wiki section I quoted. I will do that as my first contribution.

Done http://wiki.dlang.org/Get_involved#Contribute_to_the_source_code_and_documentation

On Friday, 17 April 2015 at 19:38:20 UTC, bachmeier wrote:
> On Friday, 17 April 2015 at 13:20:19 UTC, albatroz wrote:
>> On Thursday, 16 April 2015 at 17:33:09 UTC, Andrei Alexandrescu wrote:
>>> On 4/16/15 8:47 AM, bachmeier wrote:
>>> Please let me know if https://github.com/D-Programming-Language/dlang.org/blob/master/CONTRIBUTING.md floats your boat. We should make it more visible, too. -- Andrei
>>
>> Can the document be improved with additional info:
>> Were are the files to be changed?
>> How to generate new documentation files after making a change?
>>
>> Thanks
>
> That helps (and yes it should be more visible, at least on the wiki where it talks about contributing).
>
> What would be most helpful would be an example of fixing the documentation of a Phobos function. That would show how to do it as well as the kinds of changes to make.

If you're looking for examples:
https://github.com/D-Programming-Language/phobos/pulls?q=is%3Amerged+is%3Apr+author%3AMetaLang+documentation

I've been submitting PRs anywhere I think there's some ambiguity or something's not mentioned that should be. Another big one is just adding stuff like Params and Returns, etc.

Also, for anyone that cares, https://github.com/D-Programming-Language/phobos/pull/3114 has been open for 22 days and is ready to be merged.