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

[Mike Wilson <Mike_Wilson@xxxxxxxxxx>]

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.

McQ.

Jesper Eskilson ---25/05/2009 10:50:34---James Blackburn wrote:

From:	Jesper Eskilson <jesper.eskilson@xxxxxx>
To:	"CDT General developers list." <cdt-dev@xxxxxxxxxxx>
Date:	25/05/2009 10:50
Subject:	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.

-- 
/Jesper


_______________________________________________
cdt-dev mailing list
cdt-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/cdt-dev