Wiki Ubuntu Documentation a Quality Product

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

Wiki Ubuntu Documentation a Quality Product

mh-dixon
Hi.

Sorry for the subject line!  Before 13.10 was released my idea that the
community wiki documentation was difficult to use was something I just
felt as an irritation.  Now that there is more time(!!!) the idea that
"it is a mess" has, it seems, to have more than one supporter. So the
thought of some vague plan to make it better was born.

Some initial pointers (in no particular order) -
1) Who is this body of "information" aimed at?
2) Are its contents - valuable (++), useful(+), individual, specialised,
maintainable, rubbish - this needs a lot of expansion - or all of them
at once.
3) Is it practical to keep it in its present form - wiki is OK, its the
way it has been used that is the challenge.

So Martin how do you intend we should sort this mess? I hear you ask.
Together if possible., I hope.

Initial comments on the above.
1) Probably a very varied audience.  But some bits might reasonably be
brought into sub divisions.
2) Is there any reason why the whole could not (over time) be
selectively divided so that the logical parts could be addressed
separately - sounds like 1) again Martin
3) The fundamental benefit of anyone being able to create new stuff has
(like the world population) created a fundamental challenge for us all.

I trust you will see this as a genuine attempt to start a real if low
level discussion - it may not be the right medium - but I was loath to
create a"new page"!
However, if it is just the"rambling of an old man", please say so - no
need for a page just a few +1 -10s will do to start with!

Regards, Martin

--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

Re: Wiki Ubuntu Documentation a Quality Product

Svetlana Belkin
On 10/30/2013 04:51 AM, Martin Dixon wrote:
> Sorry for the subject line!  Before 13.10 was released my idea that the
> community wiki documentation was difficult to use was something I just
> felt as an irritation.  Now that there is more time(!!!) the idea that
> "it is a mess" has, it seems, to have more than one supporter. So the
> thought of some vague plan to make it better was born.

I tired to pass on an idea like yours but more trying to seek in survey
form to get numbers of users and their feedback.  [1]  You think we can
use your pointers as questions in the survey if we made one?

>[SNIP]
> I trust you will see this as a genuine attempt to start a real if low
> level discussion - it may not be the right medium - but I was loath to
> create a"new page"!

I think it's smarter to do this sort of discussion in the mailing-list
or via the forums for non-mailing-list members to chime in.

Svetlana Belkin

[1]https://lists.ubuntu.com/archives/ubuntu-doc/2013-October/018021.html
--
https://wiki.ubuntu.com/belkinsa

--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

Re: Wiki Ubuntu Documentation a Quality Product

mh-dixon
Hi Svetlana.  Thanks for your support and the link.

Use my ideas & pointers by all means and I should be very pleased to
contribute, assist, whatever in any way you care to suggest.

Re a page vs mailing-lists & forums - there is great value in any medium
to garner ideas, experience, etc.
My own position is that I have a challenge keeping too many strands tied
together - the doc meeting was a good example -
I did not "join" the meeting as I did not expect to be able to follow
it's instant progress, but found the record invaluable.

However for any of this to have any value it needs to be pulled together
in a form which will allow us to move towards unravelling the "mess" so
perhaps it might be worth having a backing page to crystallise the
results of the various strands of "enquiry".

Regards, Martin

On 30/10/13 13:33, Svetlana Belkin wrote:
<snip>
> [SNIP You think we can use your pointers as questions in the survey if
> we made one? ....
> I think it's smarter to do this sort of discussion in the mailing-list
> or via the forums for non-mailing-list members to chime in.
<snip>





--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
Reply | Threaded
Open this post in threaded view
|

Re: Wiki Ubuntu Documentation a Quality Product

Svetlana Belkin
On 10/30/2013 11:46 AM, Martin Dixon wrote:
> Hi Svetlana.  Thanks for your support and the link.

Not a problem.

> Use my ideas & pointers by all means and I should be very pleased to
> contribute, assist, whatever in any way you care to suggest.
>
> Re a page vs mailing-lists & forums - there is great value in any medium
> to garner ideas, experience, etc.

I know all three types have their pros and cons.  The main con that I
see with using a wiki page is that the MoinMoin wiki doesn't support
discussion pages like one of the wiki platforms.  But I think we can
work out a system to use wiki pages for solely discussion.

> My own position is that I have a challenge keeping too many strands tied
> together - the doc meeting was a good example -
> I did not "join" the meeting as I did not expect to be able to follow
> it's instant progress, but found the record invaluable.

Okay, from that, I can see why you prefer using wiki pages instead of
the other two ways.  Because of sub-sections, right?

> However for any of this to have any value it needs to be pulled together
> in a form which will allow us to move towards unravelling the "mess" so
> perhaps it might be worth having a backing page to crystallise the
> results of the various strands of "enquiry".

I agree here, I feel like we need to create a standard system for this.

Svetlana Belkin
--
https://wiki.ubuntu.com/belkinsa

--
ubuntu-doc mailing list
[hidden email]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc