[Issue 13153] dlang.org: provide version-specific documentation of the language and stdlib

via Digitalmars-d-bugs digitalmars-d-bugs at puremagic.com
Mon Jul 3 08:16:14 PDT 2017


https://issues.dlang.org/show_bug.cgi?id=13153

Vladimir Panteleev <dlang-bugzilla at thecybershadow.net> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |dlang-bugzilla at thecybershad
                   |                            |ow.net

--- Comment #3 from Vladimir Panteleev <dlang-bugzilla at thecybershadow.net> ---
Thanks for working on this! I hadn't looked into this yet, just had some ideas.

Building the entire website is almost surely going to be a PITA. The biggest
drawback is likely going to be that when the website's design is updated, the
old version pages are going to keep the old design, possibly including old
navigation with lots of dead links etc.

Probably the best solution is some compatibility shim (read: big pile of very
ugly hacks) that allows old versions' content to be built with the current
website design.

Building old site versions verbatim, despite the flaws, is almost surely going
to be much easier. I think Digger is the best tool for the job for this
approach, as it already knows how to build old versions of everything else.

One last thought is that we bundle HTML documentation with DMD releases
themselves. These are fairly independent of the website and could be used
directly. I hadn't looked into this yet.

--


More information about the Digitalmars-d-bugs mailing list