Re: [Ubuntu-manual] Style and content guide

I think this is great and should be useful for all content writer/editors. I also think you have some good points about our target audience that should be kept in mind, especially for those of us who have been using Ubuntu for some time where many tasks have become second nature. Keeping it accessi

[Ubuntu-manual] [Bug 504635] [NEW] factual corrections and jargon-busting

Public bug reported: This bug is regarding Manual version 0.1 ==Chapter 2== =Section 2.5 (Linux)= 1. "Linux, a member of the Unix family, is one of the oldest type of computer operating systems, dating back to the 1970s. Originating long before Windows" The

Re: [Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

Ok, I think that code blocks is the only way to go as for this matter. Why? They make it easy to distinguish between what is author-written normal text and what is a command or something. Now, I have a little suggestion here respecting commands. Commands to be entered as root should be preceded wi

[Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

** Changed in: ubuntu-manual/main Assignee: (unassigned) => jmburgess (joemburgess) ** Changed in: ubuntu-manual/main Status: Confirmed => In Progress -- Currently no uniform method of writing code and directives https://bugs.launchpad.net/bugs/504058 You received this bug notificati

[Ubuntu-manual] Manual changes

Hey Jono, Since last time I emailed you there has been quite a lot of work done. Here are the main changes: - We now have translation supportwith a tonne of languages already being worked on. - There have been some title page proposals

[Ubuntu-manual] Proposed artwork!

Okay here's something cool, Yesterday and today both wolter and vish have been hard at work trying to create a title page for our manual. I've been helping with feedback, but as always any decisions should really be from the team - so we need your help! Have a look at the submissions here: https:

[Ubuntu-manual] [Blueprint chapter10] Chapter 10 - Troubleshooting

Blueprint changed by Gilbert Mendoza: Assignee: (none) => Gilbert Mendoza -- Chapter 10 - Troubleshooting https://blueprints.launchpad.net/ubuntu-manual/+spec/chapter10 ___ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-ma

[Ubuntu-manual] [Blueprint chapter4] Chapter 4 - Around your desktop

Blueprint changed by B1ackcr0w: Assignee: Josh Holland => B1ackcr0w -- Chapter 4 - Around your desktop https://blueprints.launchpad.net/ubuntu-manual/+spec/chapter4 ___ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-manual

[Ubuntu-manual] [Blueprint contents] Table of Contents

Blueprint changed by Benjamin Humphrey: Assignee: (none) => jmburgess -- Table of Contents https://blueprints.edge.launchpad.net/ubuntu-manual/+spec/contents ___ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-manual@lists.

[Ubuntu-manual] [Blueprint formatting] Formatting of the manual

Blueprint changed by Benjamin Humphrey: Assignee: (none) => jmburgess Whiteboard set to: Added joemburgess as assignee, because he's been doing some formatting already. -- Formatting of the manual https://blueprints.edge.launchpad.net/ubuntu-manual/+spec/formatting

[Ubuntu-manual] [Bug 279507] Re: Icon for http://help.ubuntu.com should be the blue question mark

** Changed in: ubuntu-website Importance: Undecided => Wishlist -- Icon for http://help.ubuntu.com should be the blue question mark https://bugs.launchpad.net/bugs/279507 You received this bug notification because you are a member of Ubuntu Documentation Project Team, which is a direct subscri

Re: [Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

As the possibly newest Ubuntu user on the team, I find the code boxes are quite effective for training. They take the guesswork out of what verbatim means (ie do I include the quotation marks). On Jan 7, 2010 3:10 PM, "Benjamin Humphrey" wrote: Yeah maybe... I don't know if LaTeX is THAT powerf

[Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

Yeah maybe... I don't know if LaTeX is THAT powerful :S -- Currently no uniform method of writing code and directives https://bugs.launchpad.net/bugs/504058 You received this bug notification because you are a member of Ubuntu Manual Team, which is subscribed to Ubuntu Manual. Status in Ubuntu M

[Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

Could we watermark the code boxes with the Lynx that Wolter is doing? That would help differentiate them from the main body text? -- Currently no uniform method of writing code and directives https://bugs.launchpad.net/bugs/504058 You received this bug notification because you are a member of Ubu

[Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

Screenshots won't work, or graphics. Too hard to translate. Code blocks seem the best way, but pretty code blocks :) (They're notorious for looking very ugly) -- Currently no uniform method of writing code and directives https://bugs.launchpad.net/bugs/504058 You received this bug notification

Re: [Ubuntu-manual] Style and content guide

The Docs Team's style guide is aimed at a slightly different audience. Content that they work on is: - task based, rather than an overview - aims to be complete, rather than to present a coherent story for a beginner - is written in HTML, and not LaTeX I certainly think that we should keep bot

Re: [Ubuntu-manual] Translation support now ready!!

Dear Benjamin, How can I add the Persian to the list of languages? I want to start the Persian translation. Yours, Jadi Benjamin Humphrey wrote: Thanks to the wonderful work of Josh "dutchie" Holland, we now have translation support through Launchpad! For those interested in translating (I

[Ubuntu-manual] [Blueprint glossary] Glossary of Unfamiliar Terms

Blueprint changed by Parry: Assignee: (none) => Parry -- Glossary of Unfamiliar Terms https://blueprints.launchpad.net/ubuntu-manual/+spec/glossary ___ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-manual@lists.launchpad.

[Ubuntu-manual] Translation template import - ubuntu-manual in Ubuntu Manual main

Hello Ubuntu Manual Team, On 2010-01-07 15:10z (7 minutes ago), you uploaded a translation template for ubuntu-manual in Ubuntu Manual main in Launchpad. The template has now been imported successfully. Thank you, The Launchpad team ___ Mailing list

[Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

WRT code blocks, I do think that it needs setting off in some way from the rest of the text, to mark it as obviously something different (a command to be typed into the terminal) -- Currently no uniform method of writing code and directives https://bugs.launchpad.net/bugs/504058 You received this

[Ubuntu-manual] [Bug 503322] Re: Too much white space above chapter headings

** Changed in: ubuntu-manual Assignee: (unassigned) => jmburgess (joemburgess) ** Changed in: ubuntu-manual Status: In Progress => Fix Released -- Too much white space above chapter headings https://bugs.launchpad.net/bugs/503322 You received this bug notification because you are a m

[Ubuntu-manual] Good Points!

Thanks to jmburgess & John Hart for the comments on the "code box" issue. I'd never considered that point before. That'll improve the way I look at my documentation at work. Nice one guys, thank you! Alistair ___ Mailing list: https://launchpad.net/~ub

Re: [Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

Rather than a screen shot, maybe a generic graphic could be develped and the text within the graphic changed to fit the situation? jmburgess wrote: > I think if we just use screenshots for the terminal input it might be > sort of hard to read. Also, it won't be searchable which is a major > issue

[Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

I think if we just use screenshots for the terminal input it might be sort of hard to read. Also, it won't be searchable which is a major issue. I will try and throw something together in latex and push it. -- Currently no uniform method of writing code and directives https://bugs.launchpad.net/b

[Ubuntu-manual] Manual Title

The title should reflect the actual version. I know that it is 10.04 but it is really going to be _10.04 *LTS*_ for Long Term Support. That would reflect the longevity of the manual as well as that version of Ubuntu. ___ Mailing list: https://launch

[Ubuntu-manual] [Bug 340246] Re: Netbook Remix needs a seperate ubuntu-doc branch

** Changed in: ubuntu-docs (Ubuntu) Assignee: (unassigned) => Micheal_2009 (micheal-harker) ** Changed in: netbook-remix Assignee: (unassigned) => Micheal_2009 (micheal-harker) ** Changed in: ubuntu-docs Assignee: (unassigned) => Micheal_2009 (micheal-harker) ** Changed in: ubuntu

Re: [Ubuntu-manual] Media attention

Excellent! Media attention is good, now we just need to make the manual as awesome as possible! --Joe Burgess CMU Information Systems '12 (703) 402-9206 PGP key 645EF64E On 01/07/2010 04:44 AM, Alin-Andrei wrote: > > Hello, > > Well, as you know, it started with my post (on webupd8.org >

[Ubuntu-manual] [Bug 384148] Re: Major bug in Console Security help page (affects all version)

** Changed in: ubuntu-docs (Ubuntu) Assignee: (unassigned) => Micheal_2009 (micheal-harker) ** Changed in: ubuntu-docs (Ubuntu) Status: New => Confirmed -- Major bug in Console Security help page (affects all version) https://bugs.launchpad.net/bugs/384148 You received this bug notif

[Ubuntu-manual] [Bug 504152] Re: Numbering for subsubsections is ugly

** Changed in: ubuntu-manual Status: Fix Committed => Fix Released -- Numbering for subsubsections is ugly https://bugs.launchpad.net/bugs/504152 You received this bug notification because you are a member of Ubuntu Manual Team, which is subscribed to Ubuntu Manual. Status in Ubuntu Manua

[Ubuntu-manual] [Bug 504152] Re: Numbering for subsubsections is ugly

** Changed in: ubuntu-manual Status: Confirmed => In Progress ** Changed in: ubuntu-manual Status: In Progress => Fix Committed -- Numbering for subsubsections is ugly https://bugs.launchpad.net/bugs/504152 You received this bug notification because you are a member of Ubuntu Manua

[Ubuntu-manual] [Bug 504152] Re: Numbering for subsubsections is ugly

** Summary changed: - Numbering for subsubchapters is ugly + Numbering for subsubsections is ugly -- Numbering for subsubsections is ugly https://bugs.launchpad.net/bugs/504152 You received this bug notification because you are a member of Ubuntu Manual Team, which is subscribed to Ubuntu Manual

[Ubuntu-manual] Translation support now ready!!

Thanks to the wonderful work of Josh "dutchie" Holland, we now have translation support through Launchpad! For those interested in translating (I know there are a few who added their name to the list) then you can start translations: https://translations.launchpad.net/ubuntu-manual I'll update t

Re: [Ubuntu-manual] Style and content guide

Hi, What additional style guidance is needed over the Docs Team's style guide (https://wiki.ubuntu.com/DocumentationTeam/StyleGuide)? Regards, Kelvin Ilya Haykinson wrote: I've started work on a style / content guide. I'm hoping that we can get some consensus on this before too much content

Re: [Ubuntu-manual] Media attention

Hello, Well, as you know, it started with my post (on webupd8.org). I updated the post after your comment (saying it's nothing official yet), but those who saw the article before the update and didn't put a link back to the article so people could see the update ... still think it's official. Sorr

[Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

As well as looking professional, I think we need to consider how people will actually use the manual. I think it will be quite rare that folk will actually read the book from front cover to back cover. More often, they will check the index and skip forward to the chapter most relavent to them. Bec

[Ubuntu-manual] Callouts, asides, etc

I think that plain documents are not very book-like (or, rather, they are too much like textbooks, and not enough like user manuals and guides). So, any thoughts about doing something like this: http://imagebin.ca/view/xkrQ3IVx.html We could use this to have an in-line glossary, asides for a

[Ubuntu-manual] [Bug 504152] Re: Numbering for subsubchapters is ugly

you can set the counter depth in latex with \setcounter{secnumdepth}{2} also for the toc with \setcounter{tocdepth}{2} -- Numbering for subsubchapters is ugly https://bugs.launchpad.net/bugs/504152 You received this bug notification because you are a member of Ubuntu Manual Team, which is subscr

[Ubuntu-manual] Style and content guide

I've started work on a style / content guide. I'm hoping that we can get some consensus on this before too much content gets written. https://wiki.ubuntu.com/ubuntu-manual/StyleGuide Please feel free to edit/expand. -ilya haykinson ___ Mailing list

[Ubuntu-manual] [Bug 503325] Re: No translation support for project

** Changed in: ubuntu-manual Status: Confirmed => In Progress -- No translation support for project https://bugs.launchpad.net/bugs/503325 You received this bug notification because you are a member of Ubuntu Manual Team, which is a bug assignee. Status in Ubuntu Manual: In Progress Bug

[Ubuntu-manual] [Bug 503322] Re: Too much white space above chapter headings

** Changed in: ubuntu-manual Status: Confirmed => In Progress -- Too much white space above chapter headings https://bugs.launchpad.net/bugs/503322 You received this bug notification because you are a member of Ubuntu Manual Team, which is subscribed to Ubuntu Manual. Status in Ubuntu Man

[Ubuntu-manual] [Bug 504152] [NEW] Numbering for subsubchapters is ugly

Public bug reported: Is there a way to turn off numbering for subsubsections? It looks fairly crappy when you have something like 6.1.1.1 ** Affects: ubuntu-manual Importance: Low Status: Confirmed ** Changed in: ubuntu-manual Importance: Undecided => Low ** Changed in: ubuntu

[Ubuntu-manual] [Bug 504058] Re: Currently no uniform method of writing code and directives

** Changed in: ubuntu-manual/main Status: New => Confirmed -- Currently no uniform method of writing code and directives https://bugs.launchpad.net/bugs/504058 You received this bug notification because you are a member of Ubuntu Manual Team, which is subscribed to Ubuntu Manual. Status i