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
