Re: [jira] Assigned: (QPID-14) document qpid-run

[Marnie McCormack <ma...@googlemail.com>]

Must confess that I'm not in favour of docs in svn and then porting to the
wiki as I think it introduces unecessary overhead.

I think there's been previous debate on the Apache lists about the fact that
users do not read docs provided in dists but refer to project websites.

Thus I'm not keen on the svn doc/port to wiki model. Would far rather write
docs for users on the wiki. The vast bulk of our users docs are already on
the wiki btw.

The docs I'm writing will not be low level, but align with the getting
started info for users.

Marnie

On 1/30/07, Carl Trieloff <cc...@redhat.com> wrote:
>
> Johnson, Eric wrote:
> > Of course if you are talking about supplying well done man pages for the
> > commands that are nicely formatted....
> >
>
> I am proposing well done pages that format correctly into the wiki. I
> have seen this done
> very nicely on other projects, and it keeps the distro in sync with the
> doc for these overlapping
> sections
>
> Carl.
>