Re: [Banshee-List] Re move the video portion of Banshee?

["Benjamín Valero Espinosa" <benjavalero gmail com>]

2008/11/27 Eric Schultz
> The coding documentation for Banshee is severely lacking. Banshee is a
> complex piece of software but there is very little documentation to guide
> coders. To give you an example, I spent at least 12 hours trying to
> understand the start up sequence for Banshee. The sequence moves through 5
> different assemblies and starts over 10 different services plus various
> plugins. What makes all that seemingly unmanageable is there are no code
> documentation comments for methods or classes. I had to work through every
> method and class to figure out its purpose, some of which I still don't
> totally understand.
>
> Why aren't methods and classes properly documented in the code? This is
> something I consider extremely vital for maintenance. If there isn't an
> emphasis on well-documented code, perhaps there should be in the future.
>
> I think the current lack of documentation will discourage all but the most
> dedicated. This group will have to make a decision whether less
> participation from less dedicated coders is trade off they are willing to
> make.

Well, as someone who tries to help solving little bugs (besides
translating) I have to agree with Eric. It would really be very very
useful even just a little document explaining the different modules
and services. At least we have Monodevelop to browse the code easily.
Perhaps this would deserve a different thread.

Benja