Re: Version control support call for help



<snip>
Oh, it's definitely followable. Your confusion is 100% warranted. I
think you're starting to see why I'm so scared of our VC subsystem.

We don't have a documented API. Even if we *did* have an API, most of
these modules were created by someone copying another module and
munging things until they worked. So even if there was originally an
implicit API, it's long since died and we're left with a hunk of stuff
that mostly works but OH GOD DON'T TOUCH IT.

So when I say that we should leave this stuff working the way it works
now and come up with a *completely new parallel API* that makes
sense... this is why.
Fair enough. On that - given the process has started - where should it be documented? Docstrings? Still some work required if that's the case, even for the new stuff.
I'll happily add some doco as I go, just not sure where exactly to put it.

(And as an aside, this specific issue is patched here: https://bugzilla.gnome.org/show_bug.cgi?id=702057 )

Louis.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]