Improved Phobos dox

[Andrei Alexandrescu]

On 9/16/13 10:12 AM, Sönke Ludwig wrote:
> Am 16.09.2013 12:45, schrieb Andrei Alexandrescu:
>> On 9/15/13 11:34 PM, Sönke Ludwig wrote:
>>> I need some form of authoritative decision on how to go about making (or
>>> not making) the transition before I can start to work on the necessary
>>> changes to the make file and the rest of the site. There is a suggestion
>>> I made in the pull request:
>>>
>>> https://github.com/D-Programming-Language/dlang.org/pull/267
>>
>> What other changes need to be made in addition to what's in 267 now?
>>
>> Andrei
>
> My idea was to make a proper transition from the current docs to the new
> ones using a different path. Quoting from the pull:
>
>   - Adjust the make file so that the ddox documentation goes to
> "library/" and "library-prerelease/" instead of "phobos/" - leave the
> original documentation there

OK, preserve existing links and migrate later, nice.

>   - Keep the main documentation links pointed to "phobos/", but add a
> small secondary link to "library/"

Fine for the beginning. Guess we can pull the plug in a future small diff.

>   - (Optional) In the ddox documentation, add a link at the top of each
> page to the corresponding old doc page

Probably not worth the trouble, but always good if easy to implement for 
making transitioning palatable.

>   - Make the pull in this state

Ja.

>   - Incorporate improvements for a while and eventually exchange the
> links, making "library/" the default
>
> Maybe with "api" instead of "library".
>
> The current state is that the new docs have a separate make target that
> needs to be invoked explicitly, but it will write to the same "phobos"
> folder.

OK great. I'll look at it soon.


Andrei