Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: Headless build [was Re: [cdt-dev] RIP Wascana, Build System discussion]

I don't have any answers, but I have to agree with the sentiment. On the platform, we usually make the absolute minimum investment in updating the documentation that we can get away with. It's not because it's boring, it's just that there's always more work to do, and documentation isn't a high enough priority.


Inactive hide details for Jesper Eskilson ---25/05/2009 10:50:34---James Blackburn wrote:Jesper Eskilson ---25/05/2009 10:50:34---James Blackburn wrote:


Jesper Eskilson <jesper.eskilson@xxxxxx>


"CDT General developers list." <cdt-dev@xxxxxxxxxxx>


25/05/2009 10:50


Re: Headless build [was Re: [cdt-dev] RIP Wascana, Build System discussion]

James Blackburn wrote:
>> Well, Bugzilla is a really lousy way of storing documentation. You pretty
>> much guarantee that no one will find it unless they know exactly where it
>> is.
> I agree. Documentation patches are appreciated :)

One problem is that there seems to be a general consensus here that
Bugzilla is a good place to store design documentation, which I think is
a really lousy idea. Maybe while the documentation is being produced,
but using Bugzilla as a sort of DMS.

The general feeling I have is that documentation is considered (both in
CDT but even in the open-source community in general) something boring
which can be delayed until after release and left for others to
contribute. In fact, the lack of documentation in some places is a real
hindrance to CDT adoption.

I understand that fixing the current state of CDT being badly documented
requires a substantial effort to fix, and that CDT is seriously
understaffed. The problem is that things will only get worse unless all
newly developed code and new features have some form of documentation
requirement. Do they? Otherwise, the amount of undocumented features and
code will only continue to grow.


cdt-dev mailing list

GIF image

GIF image

Back to the top