ubuntu-manual team mailing list archive

[andy hayden <andyhayden1@xxxxxxxxx>]

Hi again,

I went through Draft 5 (trying not to repeat the comments which I made in
Draft 4), @Hannie in passing I commented on the highlighted bits without
comments (at least what I thought they could be).

Things which jump out:
Chapter 3, section "All The Applications You Need" is quite inconsistent
and many of the app-type subsections run into wild opinion! It could really
do with a structure (for each app-type) and an overall aim for the
section... I found it very hard to understand/read.

"Reading and composing email" section is really tough to read: it's missing
capitalisation, bolding and emphasis (though I think the content is good).

Large pictures center across the entire page rather than center across the
text (which looks strange), perhaps these large pictures should be shrunk?

The naming convention chosen in its chapter is "Dash" rather than "dash",
"the dash", "the dash", "the Dash", or "The Dash" (all are in use somewhere
in the text! :) )

Many sections use the bolding/italic special character > incorrectly, and
have instead used quotations ' ' (these look even stranger as quotations
should be ` '). The majority of the manual where these are used correctly
is very easy to read, and I suspect user-friendly - once the reader has the
hang of it!

Sorry everything seems negative, but all the other things are coming along
great!
Andy

On 7 November 2011 18:51, c7p <c7p.admin@xxxxxxxxx> wrote:

> Yeah i think that's a common issue. I remember when i was trying to get
> the Greek manual built, that was one "traditional" bug -Kevin fixed such
> bugs pretty quickly-.
>
> Have a nice week !
> --John
>
> 2011/11/7 tom.swartz07@xxxxxxxxx <tom.swartz07@xxxxxxxxx>
>
> Hey all,
>>
>> Im just looking through the online draft now, and I notice that all of
>> the references are incorrect. e.g. My section on Using Instant Messaging is
>> listed in the Table of Contents as page 66, but appears on page 68 in the
>> text.
>> I have reason to believe that the LaTeX file compiler was only run once
>> (Am I correct in assuming this?). Typically when a TeX document is compiled
>> with complex references, it needs to be 're compiled' so that the TOC could
>> be loaded correctly.
>>
>> That said, its no big deal to simply run it twice before the final draft
>> is published, and it shouldn't really affect any of the edits that we are
>> currently doing, but it is something important to keep in mind when anyone
>> is compiling the TeX from source.
>>
>> Ill push the edits to the Troubleshooting section that I have made after
>> I get home from work tonight. :)
>>
>> Cheers,
>> Thomas Swartz
>>
>> No trees were killed to send this message, but a large number of
>> electrons were terribly inconvenienced.
>>
>>
>> On Mon, Nov 7, 2011 at 7:03 AM, c7p <c7p.admin@xxxxxxxxx> wrote:
>>
>>>
>>>
>>> 2011/11/7 andy hayden <andyhayden1@xxxxxxxxx>
>>>
>>>> Hi,
>>>>
>>>> I added many comments to Draft 4 (http://crocodoc.com/Oog1F8n) last
>>>> week, none of which appear to have been addressed in Draft 5.
>>>>
>>>> many thanks
>>>> Andy
>>>>
>>>> On 7 November 2011 09:50, lafeber-dumoleyn2 <
>>>> lafeber-dumoleyn2@xxxxxxxxx> wrote:
>>>>
>>>>> **
>>>>> Hi,
>>>>> I have added some comment here: https://crocodoc.com/FcDBmlM.
>>>>> I can see in this document that text is highlighted, but there is no
>>>>> comment. It is not always clear what the problem is.
>>>>> Hannie
>>>>>
>>>>> _______________________________________________
>>>>> Mailing list: https://launchpad.net/~ubuntu-manual
>>>>> Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
>>>>> Unsubscribe : https://launchpad.net/~ubuntu-manual
>>>>> More help   : https://help.launchpad.net/ListHelp
>>>>>
>>>>>
>>>>
>>>> _______________________________________________
>>>> Mailing list: https://launchpad.net/~ubuntu-manual
>>>> Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
>>>> Unsubscribe : https://launchpad.net/~ubuntu-manual
>>>> More help   : https://help.launchpad.net/ListHelp
>>>>
>>>>
>>> @Andy: Thanks for the info, we'll make the changes asap.
>>>
>>> @Hannie: I don't know why this is happening, i guess you would have to
>>> add comments again if they are necessary -double-work isn't the most
>>> pleasing thing- :/.
>>>
>>> --John
>>>
>>> _______________________________________________
>>> Mailing list: https://launchpad.net/~ubuntu-manual
>>> Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
>>> Unsubscribe : https://launchpad.net/~ubuntu-manual
>>> More help   : https://help.launchpad.net/ListHelp
>>>
>>>
>>
>