| Re: [eigen] Bugs on bugzilla |
[ Thread Index |
Date Index
| More lists.tuxfamily.org/eigen Archives
]
Dear Jitse,
On 08.04.2014 09:48, Jitse Niesen wrote:
I talked with Christoph on IRC earlier today about the amount of bugs
and other issues on bugzilla. The issue is that the number is growing
all the time; there are almost 300 open at the moment.
That in itself is perhaps not that much a problem though a bit
overwhelming. The real danger is that important bugs slip through.
Especially bad is when users submit a patch and nobody looks at it,
which does happen.
What can we do about this?
Why are there so many bugs / issues? Some issues are feature requests
that no developer is really interested in. Some are bugs on exotic
platforms that no developer has access to. Some bugs need discussion
(e.g., bug 662 on input operators).
But the main problem is a lack of manpower; or to put it another way,
the library is too big for the number of people working on it. This
is compounded by the fact that some parts of the code base (e.g.,
product, I think) are only really understood by one guy (Gael). So
improving the process and the bug tracker will not solve everything.
Christoph suggested that we have an IRC meeting to go through the
bugs and discuss them so to prioritize / downgrade / close /
delegate. Another suggestion is to enable voting on bugzilla to help
us prioritize the issues.
Any other ideas?
thank you for pointing out the current situation. There are a few more
observations:
In the Eigen source code simple or straight forward algorithms are often
well-documented. But unfortunately, the documentation of much more
advanced and complicated parts of the code (e.g. the template core part)
is very sparse, what might discourage newcomers. Of course, this is a
natural effect, but we should try to go against that. I know that
currently, core parts are rewritten for the evaluators, it would be
great if the concepts of the new code would be easier to understand.
In fact, Gael's presentation slides from Eurographics/CGLibs in Pisa
available on <http://eigen.tuxfamily.org/index.php?title=Publications>
helped me a lot to understand more on the architectural concepts behind
Eigen, but the link to this web page and the PDF file is not so easy to
find.
Therefore, possible strategies to attract more new contributors - and I
am quite sure that many users would like to contribute if the learning
curve was not so steep - could include the following issues:
* An improvement of the documentation in the code would be a great step
forward. In particular the documentation of the essential core parts and
the template mechanisms underlying the library would be very helpful.
Moreover, the concepts behind Eigen and its API need to be documented in
more detail, preferably outside the code.
* A review and a classification of the bugs possibly is also a good
idea. Maybe we can also rate them by how hard it probably is to fix
them [from "easy" (standard C++ knowledge is enough) via "advanced"
(additional knowledge on numerics or template metaprogramming necessary)
to "for experts only" (deep insight into Eigen internal structures
required)]. Then new contributers can get started with easy ones and
grow with the tasks.
* By setting up a kind of mentoring program for bug fixing new
contributors could learn much faster from current experts.
--
Best regards,
Kolja