Suggestion

Sat Sep 14 20:47:29 UTC 2013

Hi John,

there is help on moin-moin available in two links each time you edit a
page. Another good source is http://moinmo.in/WikiCourse/08%20Hot%20Keys (I've
started you at page 8 in the slides as the earlier ones deal more with
creating a moin moin wiki area).

Feel free to ask on here if you have questions, once you get the basics
mastered, heading onto to table etc is quite painless. Also, do look at
pages that have the sort of formatting you want and look at how they
achieved it. https://wiki.ubuntu.com/Testing/Activities/Classroom/Saucy was
based on a couple of other pages that had the general sort of formatting I
wanted.

Regards,

Phill.

On 14 September 2013 21:22, John Kim <johnkim.ubuntu at gmail.com> wrote:

> Hey Tom,
>
> Regarding your first of the two rants, it's a matter of initiative and
> throwing themselves out there. Making mistakes is the way to learn, as I
> have figured.
>
> For the second one, as for me, I would love to learn coding and markup for
> docbook and wiki, but I haven't really found the appropriate training or
> mentorship yet. The experienced ones usually take care of that, when they
> are active, of course. I only wish they could make their expertise
> available and open opportunities for such technical tasks.
>
> Tom Davies <tomdavies04 at yahoo.co.uk>이 씀:
>
>> Hi :)
>> I tend to think it's harder to post a bug-report than to edit the page,
>> such as to leave a note at the end of the page or just after the bit that
>> didn't work.
>>
>> However i am beginning to believe what Jonathon just pointed out.  I
>> think perhaps 2 main reason but probably others too;
>> 1.  even a lot of trained documenters can't cope with coding, even
>> wiki-markup is scary to a lot of folks
>> 2.  people are too shy and worry about messing things up if they type in
>> a couple of words into a page
>> < off-topic rant>
>> Perhaps feeling they have to be submissive to some higher authority or
>> something.  It drives me nuts.  I'd hoped it was just in my country but i'm
>> beginning to think even people in democracies (if there are any) bow to
>> their 'superiors'.
>> </ off-topic rant>
>>
>> <new rant>
>> It's as though people have never heard of or used wikipedia or wiki's, as
>> though they are all tooo new despite having been around since the last
>> century.
>> </ new rant>
>>
>> Anyway, the point is that these tags clearly come from a higher authority
>> than an average user so they will give sheeple and normal users much
>> greater confidence in the pages that are not tagged as being for
>> unsupported versions.  It will also give normal users the correct
>> impression, that they can complain to the higher authority and it
>> encourages them to find one of the many ways they could do so.  So it
>> benefits 2 groups we need to reach without harming those that already "get
>> it".
>> Regards from
>> Tom :)
>>
>>
>>   ------------------------------
>>  *From:* Jonathan Aquilina <eagles051387 at gmail.com>
>> *To:* Tom Davies <tomdavies04 at yahoo.co.uk>
>> *Cc:* Phill Whiteside <phillw at vpolink.com>; Ubuntu Doc <
>> ubuntu-doc at lists.ubuntu.com>
>> *Sent:* Friday, 13 September 2013, 21:20
>> *Subject:* Re: Suggestion
>>
>> the way things are now you have to work with trial by error with the
>> current state of the docs. At least like this me as an end user can file a
>> bug against the docs team for a particular page if they notice hey this
>> version doesn't work with the current release can you update it please.
>>
>>
>> On Fri, Sep 13, 2013 at 10:18 PM, Tom Davies <tomdavies04 at yahoo.co.uk>wrote:
>>
>> Hi :)
>> Yes, everyone sees tags.
>>
>> I think both ideas have merit.  I kinda wish the tag said
>> *Unsupported Version:* This article appears to apply to unsupported
>> versions of Ubuntu.
>> or something else less definite that the way it is set at the moment.
>>
>> If something definitely only applies to unsupported versions then it
>> should definitely be removed but i think there are a lot of pages where
>> it's unclear or where just a bit of updating or pruning large chunks out
>> might fix the page.  However, even so, i think it would be good to use the
>> tag as it is to see if it helps shake things up a bit.
>>
>> I also quite like Jonathon's idea of listing some of the versions the
>> page is known to work with.  I think there are dangers with it but even so
>> it's worth considering imo.
>>
>> Regards from
>> Tom :)
>>
>>
>>
>>   ------------------------------
>>  *From:* Jonathan Aquilina <eagles051387 at gmail.com>
>> *To:* Phill Whiteside <phillw at vpolink.com>
>> *Cc:* Tom Davies <tomdavies04 at yahoo.co.uk>; Ubuntu Doc <
>> ubuntu-doc at lists.ubuntu.com>
>> *Sent:* Friday, 13 September 2013, 21:05
>> *Subject:* Re: Suggestion
>>
>> will tags show up to those that visit the page? like me a reader and user
>> of the wiki would it show the tags?
>>
>>
>> On Fri, Sep 13, 2013 at 10:05 PM, Phill Whiteside <phillw at vpolink.com>wrote:
>>
>> Hi,
>>
>> having just had a new tag [1] added maybe we can use these?
>>
>> Regards,
>>
>> Phill.
>> 1. https://help.ubuntu.com/community/Tag
>>
>>
>> On 13 September 2013 20:06, Jonathan Aquilina <eagles051387 at gmail.com>wrote:
>>
>> maybe so but it will give users a heads up hey maybe the doc team should
>> be informed this page doesnt support the release that i am on
>>
>>
>> On Fri, Sep 13, 2013 at 8:49 PM, Tom Davies <tomdavies04 at yahoo.co.uk>wrote:
>>
>> Hi :)
>> I think we need to be wary of that sort of thing.  It can make a page
>> appear outdated even if it's contents are still valid and just means people
>> have to take care to edit every single page even if it's only for that 1
>> thing.
>>
>> It has always been my worry that it's the only reason some of our current
>> pages have a bad reputation for being old.  The advice might still be solid
>> but the version numbers are so out of date that the page is in danger of
>> getting deleted and the wisdom or cunning lost.  Since the move to Unity
>> that has been a lot less of an issue and i am beginning to agree it would
>> be good to just wipe out a large number of pages, or at least stop them
>> from being publicly accessible, but probably just deleting would be best.
>>
>> Regards from
>> Tom :)
>>
>>
>>   ------------------------------
>>  *From:* Jonathan Aquilina <eagles051387 at gmail.com>
>> *To:* Ubuntu Doc <ubuntu-doc at lists.ubuntu.com>
>> *Sent:* Friday, 13 September 2013, 19:12
>> *Subject:* Suggestion
>>
>> Is it possible to put on the page a list of versions that the steps to
>> setup something applies to that way if and when somethign changes then we
>> know that hey these documents need to be updated to include said stuff for
>> this particular version.
>>
>> --
>> Jonathan Aquilina
>>
>> --
>> ubuntu-doc mailing list
>> ubuntu-doc at lists.ubuntu.com
>> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>>
>>
>>
>>
>>
>> --
>> Jonathan Aquilina
>>
>> --
>> ubuntu-doc mailing list
>> ubuntu-doc at lists.ubuntu.com
>> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>>
>>
>>
>>
>> --
>> https://wiki.ubuntu.com/phillw
>>
>>
>>
>>
>> --
>> Jonathan Aquilina
>>
>>
>>
>>
>>
> --
> Sent from my Android device with K-9 Mail. Please excuse my brevity.
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>
>

-- 
https://wiki.ubuntu.com/phillw
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20130914/871bcff2/attachment-0001.html>