Re: [cdt-dev] CDT docs and need Info on Indexer pref panel

[Andrew Gvozdev <angvoz.dev@xxxxxxxxx>]

Hi James,

> What do people think about opening up the documentation to the 
community?
I think it is a great idea. +1 for that.

Andrew

On Tue, Apr 13, 2010 at 3:36 PM, James Blackburn <jamesblackburn@xxxxxxxxx> wrote:

Hi Frank,

That sounds like a really noble cause!

There are a few things I've found problematic when working with the
documentation (both while tweaking, and as a user) that I thought it
would be good to enumerate:
 - Much of it was created using FrontPage and isn't easy for
developers (if they have the inclination) to improve with a text
editor
 - Many existing features are documented 3 times: under tasks,
concepts and reference.   As a user you need to look in all 3 places.
 - The documentation is locked away in CVS.

The last point is the most major in my mind. It's near impossible for
people to contribute improvements to the documentation.  The recent
user-contributions I've seen fly-by have been for typos rather than
anything substantial...

A number of projects have jumped on the documenation crowd-sourcing
band-wagon.  There are a few blog posts about it:
http://aniszczyk.org/2010/03/13/crowdsourcing-documentation-at-eclipse/
http://greensopinion.blogspot.com/2010/03/crowdsourcing-documentation-made-easy.html

We're really lucky to have some dedicated question-answerers on the
Eclipse forums. It would be great to tap some of the community and get
them to help out with improving our documentation situation.  IMHO
developers often don't make the best documenters, and only the
community at large can point out the deficiencies that we'd never see.
Having spent the afternoon facing users (internal ones at that) it's
really amazing what knowledge/concepts we take for granted...

What do people think about opening up the documentation to the community?

Cheers,
James

On 13 April 2010 20:00,  <Frank.Turovich@xxxxxxxxx> wrote:
> Okay, now that taxes are done I'm turning my attention to the CDT docs. Over the next few weeks I'm going to attempt to:
>
> - review all my previous patches and see if they still apply. If they do, I'll commit the patch and mark the bug as fixed. If the initial patch can no longer be applied, I'll update with a new version and apply that, then again close the bug.
>
> - review all other CDT doc bugs and patch as many as I can
>
> - rearrange the CDT manual's TOC > Pref panels section to more closely match what the user  finds in the current release.
>
> - start filling in obvious doc holes.
>
> And that's where I need your help. One of the big pref panels not covered is the Indexer. Where can I find more information of its design goals and options so I can document them for our users?
>
> All input appreciated.
>
> thx // frank
>
> _______________________________________________
> cdt-dev mailing list
> cdt-dev@xxxxxxxxxxx
> https://dev.eclipse.org/mailman/listinfo/cdt-dev
>
_______________________________________________
cdt-dev mailing list
cdt-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/cdt-dev