← Back to team overview

ubuntu-manual team mailing list archive

Re: Shared pdf draft 5

 

Hi Andy,
Comment like this is exactly what we need. Many thanks!
There is still some work to do for the editors. If editors take care of
"their" chapter or section, I think we can have an (almost) perfect
document in no time :)
Hannie

andy hayden schreef op ma 07-11-2011 om 21:04 [+0000]:

> 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
>                         
>                 
>                 
>                 
>         
>         
> 
> 
> 
> 
> _______________________________________________
> 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



Follow ups

References