← Back to team overview

ubuntu-manual team mailing list archive

Re: Shared pdf draft 5

 

So,

Regarding terminology, should it be called: Dash, dash, the Dash, or the dash?

I don't know that we have clear guidance.


Rickfosb






Sent from my iPad

On Nov 7, 2011, at 3:04 PM, andy hayden <andyhayden1@xxxxxxxxx> wrote:

> 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