no-autodecode -- game plan
Andrei Alexandrescu
SeeWebsiteForEmail at erdani.com
Wed Aug 19 13:51:23 UTC 2020
On 8/19/20 9:21 AM, Adam D. Ruppe wrote:
> On Wednesday, 19 August 2020 at 13:10:29 UTC, Andrei Alexandrescu wrote:
>> Don't copy everything, alias everything that doesn't need change and
>> only add the declarations that should be changed.
>
> Yes, that too.
>
>> The only problem I see with this is documentation. We need to have an
>> easy way to define and navigate documentation for different versions
>> of the stdlib.
>
> My dpldocs.info can already pull any specific version you want from git:
>
> http://phobos.dpldocs.info/v2.076.0/std.algorithm.html
>
> just a fun fact. I've kinda wanted it to show automatic change logs in
> the past but haven't gotten around to that yet...
>
> But anyway, with aliases, they'd be hyperlinked automatically (at least
> by my doc gen) and with different major version package namespaces, all
> would be available naturally.
>
> I'm convinced we could make it work, if it doesn't already, it shouldn't
> be insurmountable tweaks to the doc generators.
>
>> That article by Yegge once more convinced me - we need to stop
>> (thinking of) changing and start adding. We've been paralyzed by the
>> fear of change while the opportunity (made even better by a nice
>> module system) was always there.
>
> Glad to see others finally seeing this! Back before dub came out I
> argued we should use the module system for this and found no traction. I
> even gave up on doing it myself (but instead I simply don't break my
> code - the arsd library has had a total of 8 breaking changes going back
> a decade across all 70+ of its modules and most of them are trivial).
>
> But it still remains on my mind as a viable thing to explore in more
> detail someday.
I thought of adding: "Cue plug of adrdox" to my message, but I knew it
was unnecessary :o).
Versioning stdlib might require significant changes to ddoc or an
opportunity for adrdox to differentiate itself.
More information about the Digitalmars-d
mailing list