[Typo3-UG UK] Documentation, planning, deligation (and more Typo3-UK meetings?)

[dan frost]

I agree - but the problem is that, whereas many of the community agree 
that documentation is needed, the effort isn't always coordinated. Which 
results in the present state of the documentation.

Something which came out of the group meeting was the idea of workshops 
for interested parties, and clients. Client, or course, will want nice 
documentation to learn from. And this is the impetus behind the UKUG 
setting up a documentation project.

I think we should build documentation around the needs of the user 
(group) in the uk - as that's the UKUG's concern. We should also involve 
the wider community, but starting small and focused will (i think) make 
for a better result.

So, as a kind of plan, I propose we:
- Draw up the wish-list of documentation -- focused on the workshops
- Write up the findings (I can do the first draft, which I'll base on 
the meeting, and postings on this and other mailing lists)
- Publish the findings (as a specification - i.e. need to write this 
chapter; that chapter...) - on the main mailing lists

Then, the whole community is involved, the UKUG has clear aims for 
itself, and the wider community has a clear idea of the needs of users.

(I should perhaps have waited for Dom's meeting write-up...)

dan


Nigel Jackson wrote:

> dan frost wrote:
>
>> I think what we also need is a trouble shooting list for each area of 
>> the program.
>>
>> For example, a TypoScript trouble shooting list would list ALL of the 
>> places that information can be found to help diagnos a problem. A 
>> similar thing for extensions, and so on, also..
>
>
>
> it seems that the age-old question of documentation was discussed at 
> the meeting...that's not a bad thing, as there still is a lot to improve.
>
> what I'm not sure about is whether the UK list is the place for this 
> to be discussed and planned...what about getting input from the rest 
> of the community? I realise that often there's a lot of talk and no 
> action, but at least everyone should be given the opportunity to put 
> forward their suggestions and comments...then if there's no other 
> interest in actually getting on with the job, go ahead. I don't think 
> that starting a UK-only documentation project without any wider 
> discussion is the right thing to do.
>
> ...or maybe i just got half the story, so can someone fill me in on 
> the other half!?
>
> Nige
>
>
>
> _______________________________________________
> Typo3-uk mailing list
> Typo3-uk at lists.netfielders.de
> http://lists.netfielders.de/cgi-bin/mailman/listinfo/typo3-uk
>
>