[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-kimageshop
Subject: Re: Krita shared pointers usage
From: Stefano Bonicatti <smjert () gmail ! com>
Date: 2014-12-20 20:03:15
Message-ID: CAGMAV48ABy2nzw80TEjtcDehXLSJJaif-xEfpiyp7RzhRntGmw () mail ! gmail ! com
[Download RAW message or body]
[Attachment #2 (multipart/alternative)]
2014-12-20 20:35 GMT+01:00 Boudewijn Rempt <boud@valdyas.org>:
>
> Oh sure, and we've tried to start documentation a lot of times. The big
> problem is that architecture changes, and often quite quickly, and then the
> documentation becomes outdated. Of course, that's not peculiar to Krita,
> I've _never_ seen an adequately documented project.
>
I'm not referring specifically to Krita but it changes to have no
documentation from at least have an high level one that explains why
certain things are laid like that.
Especially when there are several layers of indirection due to design
pattern and events, where it's not that easy to track where interactions
may come from.
This is just to lower a wall that i see in every big project. One may say
that it is there to keep not very expert devs to make damage but... imho it
actually keeps away interested and capable people with not that much time
to dig the whole code and to bug the devs.
And then, there's the problem that most developers are good at coming up
> with designs but extremely bad at understanding other people;s work,
> leading to a tendency to excessive refactoring. The "I had an idea how it
> should have been done, now I'm looking a the code and it isn't done the way
> I imagined it would be done, so it must be redone."
>
Well i would say that this often happens exactly because they don't
understand the work and more than else why is done like that, so they think
there's a better way. If it was explained i would guess that it wouldn't be
much of a problem.
I have to say that you are very available for questions and explaining
things, but having to do this each time for everyone... wouldn't be better
to write it (kind of) once?
[Attachment #5 (text/html)]
<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">2014-12-20 20:35 \
GMT+01:00 Boudewijn Rempt <span dir="ltr"><<a href="mailto:boud@valdyas.org" \
target="_blank">boud@valdyas.org</a>></span>:<blockquote class="gmail_quote" \
style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"> Oh sure, and \
we've tried to start documentation a lot of times. The big problem is that \
architecture changes, and often quite quickly, and then the documentation becomes \
outdated. Of course, that's not peculiar to Krita, I've _never_ seen an \
adequately documented project.<br></blockquote><div> </div><div>I'm not \
referring specifically to Krita but it changes to have no documentation from at least \
have an high level one that explains why certain things are laid like \
that.</div><div>Especially when there are several layers of indirection due to design \
pattern and events, where it's not that easy to track where interactions may come \
from.</div><div>This is just to lower a wall that i see in every big project. One may \
say that it is there to keep not very expert devs to make damage but... imho it \
actually keeps away interested and capable people with not that much time to dig the \
whole code and to bug the devs.</div><div><br></div><blockquote class="gmail_quote" \
style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"> And then, \
there's the problem that most developers are good at coming up with designs but \
extremely bad at understanding other people;s work, leading to a tendency to \
excessive refactoring. The "I had an idea how it should have been done, now \
I'm looking a the code and it isn't done the way I imagined it would be done, \
so it must be redone."<br></blockquote><div><br></div><div>Well i would say that \
this often happens exactly because they don't understand the work and more than \
else why is done like that, so they think there's a better way. If it was \
explained i would guess that it wouldn't be much of a \
problem.</div><div><br></div><div>I have to say that you are very available for \
questions and explaining things, but having to do this each time for everyone... \
wouldn't be better to write it (kind of) \
once?</div><div><br></div><div><br></div></div></div></div>
_______________________________________________
Krita mailing list
kimageshop@kde.org
https://mail.kde.org/mailman/listinfo/kimageshop
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic