Folks, looks like there are multiple breakages in the Phobos documentation build for dlang.org. Could someone look into this pronto? -- Andrei

On 5/29/15 3:35 PM, Andrei Alexandrescu wrote:
> Folks, looks like there are multiple breakages in the Phobos
> documentation build for dlang.org. Could someone look into this pronto?
> -- Andrei

I'm working on the UnixAddress issues, will have a PR after I verify it passes the normal tests.

-Steve

On 5/29/15 3:47 PM, Steven Schveighoffer wrote:
> On 5/29/15 3:35 PM, Andrei Alexandrescu wrote:
>> Folks, looks like there are multiple breakages in the Phobos
>> documentation build for dlang.org. Could someone look into this pronto?
>> -- Andrei
>
> I'm working on the UnixAddress issues, will have a PR after I verify it
> passes the normal tests.

PR: https://github.com/D-Programming-Language/phobos/pull/3344

And BTW, how can we get the ddoc build to be part of the auto tester? It's kind of important. Luckily, it's only built on one platform, we can pick the fastest.

If at all possible, if the auto generated ddocs could be available for the PR, that would be hugely helpful. Right now, when ddoc changes are made, you have to build them locally to see the changes.

-Steve

On Friday, 29 May 2015 at 21:35:23 UTC, Andrei Alexandrescu wrote:
> Folks, looks like there are multiple breakages in the Phobos documentation build for dlang.org. Could someone look into this pronto? -- Andrei

https://github.com/D-Programming-Language/druntime/pull/1289/files
https://github.com/D-Programming-Language/phobos/pull/3346

On 5/29/15 3:56 PM, Steven Schveighoffer wrote:
> On 5/29/15 3:47 PM, Steven Schveighoffer wrote:
>> On 5/29/15 3:35 PM, Andrei Alexandrescu wrote:
>>> Folks, looks like there are multiple breakages in the Phobos
>>> documentation build for dlang.org. Could someone look into this pronto?
>>> -- Andrei
>>
>> I'm working on the UnixAddress issues, will have a PR after I verify it
>> passes the normal tests.
>
> PR: https://github.com/D-Programming-Language/phobos/pull/3344
>
> And BTW, how can we get the ddoc build to be part of the auto tester?
> It's kind of important. Luckily, it's only built on one platform, we can
> pick the fastest.
>
> If at all possible, if the auto generated ddocs could be available for
> the PR, that would be hugely helpful. Right now, when ddoc changes are
> made, you have to build them locally to see the changes.
>
> -Steve

cc Brad Roberts -- Andrei

On Fri, May 29, 2015 at 03:56:43PM -0600, Steven Schveighoffer via Digitalmars-d wrote:
> On 5/29/15 3:47 PM, Steven Schveighoffer wrote:
> >On 5/29/15 3:35 PM, Andrei Alexandrescu wrote:
> >>Folks, looks like there are multiple breakages in the Phobos documentation build for dlang.org. Could someone look into this pronto? -- Andrei
> >
> >I'm working on the UnixAddress issues, will have a PR after I verify it passes the normal tests.
> 
> PR: https://github.com/D-Programming-Language/phobos/pull/3344
> 
> And BTW, how can we get the ddoc build to be part of the auto tester? It's kind of important. Luckily, it's only built on one platform, we can pick the fastest.

There's a problem with building it on just one platform: platform-specific docs don't get built. For example, std.windows.* isn't getting built at all. Even if we added it to the makefile, it still wouldn't work, since it's version'd out by platform.


> If at all possible, if the auto generated ddocs could be available for the PR, that would be hugely helpful. Right now, when ddoc changes are made, you have to build them locally to see the changes.
[...]

+1. This would be an incredibly useful addition to the autotester.


T

-- 
Designer clothes: how to cover less by paying more.

On 5/29/15 4:02 PM, Andrei Alexandrescu via Digitalmars-d wrote:
> On 5/29/15 3:56 PM, Steven Schveighoffer wrote:
>>
>> PR: https://github.com/D-Programming-Language/phobos/pull/3344
>>
>> And BTW, how can we get the ddoc build to be part of the auto tester?
>> It's kind of important. Luckily, it's only built on one platform, we can
>> pick the fastest.
>>
>> If at all possible, if the auto generated ddocs could be available for
>> the PR, that would be hugely helpful. Right now, when ddoc changes are
>> made, you have to build them locally to see the changes.
>>
>> -Steve
>
> cc Brad Roberts -- Andrei

I agree that some sort of testing infrastructure should be built for documentation build, review, and testing.  I don't believe that the needs overlap sufficiently with code building and testing and can be made generic enough (the d doc tooling is _very_ specific to d) to fit into a generic CI tool that it fits within the current auto-tester.  There's certainly some very high level overlaps, but ultimately, I believe that something dedicated to documentation build/review/testing would be a better path.

On Friday, 29 May 2015 at 21:56:43 UTC, Steven Schveighoffer wrote:
> And BTW, how can we get the ddoc build to be part of the auto tester?

Not as good as testing PRs, but I added an hourly cronjob to the staging site. At least now I'll know if something we merged broke building the website.

On 5/30/15 4:06 AM, Vladimir Panteleev wrote:
> On Friday, 29 May 2015 at 21:56:43 UTC, Steven Schveighoffer wrote:
>> And BTW, how can we get the ddoc build to be part of the auto tester?
>
> Not as good as testing PRs, but I added an hourly cronjob to the staging
> site. At least now I'll know if something we merged broke building the
> website.

thanks!

-Steve

On 5/30/15 5:29 AM, Steven Schveighoffer wrote:
> On 5/30/15 4:06 AM, Vladimir Panteleev wrote:
>> On Friday, 29 May 2015 at 21:56:43 UTC, Steven Schveighoffer wrote:
>>> And BTW, how can we get the ddoc build to be part of the auto tester?
>>
>> Not as good as testing PRs, but I added an hourly cronjob to the staging
>> site. At least now I'll know if something we merged broke building the
>> website.
>
> thanks!

For my understanding, where is the staging area? Is it this?

http://dlang.org/phobos-prerelease/index.html

-Steve