xubuntu-devel Digest, Vol 84, Issue 20

[Jay van Cooten]

On 16/09/12 13:00, xubuntu-devel-request at lists.ubuntu.com wrote:
> Send xubuntu-devel mailing list submissions to
> 	xubuntu-devel at lists.ubuntu.com
>
> To subscribe or unsubscribe via the World Wide Web, visit
> 	https://lists.ubuntu.com/mailman/listinfo/xubuntu-devel
> or, via email, send a message with subject or body 'help' to
> 	xubuntu-devel-request at lists.ubuntu.com
>
> You can reach the person managing the list at
> 	xubuntu-devel-owner at lists.ubuntu.com
>
> When replying, please edit your Subject line so it is more specific
> than "Re: Contents of xubuntu-devel digest..."
>
>
> Today's Topics:
>
>    1. Re: Documentation review update (Jack Fromm)
>    2. Re: Documentation review update (Pasi Lallinaho)
>    3. Re: Documentation review update (Jack Fromm)
>
>
> ----------------------------------------------------------------------
>
> Message: 1
> Date: Sat, 15 Sep 2012 13:20:10 -0400
> From: Jack Fromm <jjfrv8 at gmail.com>
> To: Xubuntu Development Discussion <xubuntu-devel at lists.ubuntu.com>
> Subject: Re: Documentation review update
> Message-ID: <5054B8CA.50405 at gmail.com>
> Content-Type: text/plain; charset=ISO-8859-1; format=flowed
>
>
> On 09/15/2012 01:15 PM, Pasi Lallinaho wrote:
>> Hey,
>>
>> the pages needing review is (second line is for additional/especial
>> points of interest):
>>
>> 2/Upgrading from and older version of Xubuntu
>>      See
>> https://lists.ubuntu.com/archives/xubuntu-devel/2012-September/008467.html
>>
>> 4/Quick Quide to default applications
>>      Links to support pages should be moved to the end of the lines (see
>> the "Internet" subsection)
>>
>> 5/Photos and Cameras
>>
>> 6/Network connections
>>      See
>> https://lists.ubuntu.com/archives/xubuntu-devel/2012-September/008466.html
>> 6/Troubleshooting
>>      See
>> https://lists.ubuntu.com/archives/xubuntu-devel/2012-September/008466.html
>> 6/Connecting to servers
>>      Check if application paths are correct
>>
>> 7/Printing
>> 7/Scanning
>>
>> Cheers,
>> Pasi
>>
> I just confirmed 6/Connecting to servers. I figured I was allowed to 
> confirm it because I was incorrectly listed as the submitter.
>
> 6/Connecting to servers
>      Check if application paths are correct
>
>
>
>
> ------------------------------
>
> Message: 2
> Date: Sat, 15 Sep 2012 20:21:04 +0300
> From: Pasi Lallinaho <pasi at shimmerproject.org>
> To: Xubuntu Development Discussion <xubuntu-devel at lists.ubuntu.com>
> Subject: Re: Documentation review update
> Message-ID: <5054B900.7000507 at shimmerproject.org>
> Content-Type: text/plain; charset=ISO-8859-1
>
> On 09/15/2012 08:20 PM, Jack Fromm wrote:
>> On 09/15/2012 01:15 PM, Pasi Lallinaho wrote:
>>> Hey,
>>>
>>> the pages needing review is (second line is for additional/especial
>>> points of interest):
>>>
>>> 2/Upgrading from and older version of Xubuntu
>>>      See
>>> https://lists.ubuntu.com/archives/xubuntu-devel/2012-September/008467.html
>>>
>>>
>>> 4/Quick Quide to default applications
>>>      Links to support pages should be moved to the end of the lines (see
>>> the "Internet" subsection)
>>>
>>>
I thought about that. Thing is though, text wise every sentence will end
in " More information about this ..." which not only makes for boring
reading but also an unreadable document as the reader will have trouble
focussing on the right line.
The idea of the quick guide in my opinion was to explain in one or two
lines what it's used for but to refer for detailed documentation
elsewhere. Why do double work ?

Just a thought

Jay
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/xubuntu-devel/attachments/20120916/b04f5c29/attachment.html>