FAQ

Revision 15 as of 2010-01-07 23:05:31

Clear message

Frequently Asked Questions

How can I contribute?

What's the point in this Project, isn't there already enough documentation around?

Is this official?

  • No. It is not officially supported by Canonical at the moment. But we are working on making it "official."

I want to write a blog post on this, can I?

  • Yes you sure can. You're welcome to use our images from the Screenshots/Artwork page. But there are two things you need to make clear: 1) That this manual is NOT official at the moment, and is NOT guaranteed to be included on the Ubuntu CD. 2) The screenshots and title page etc are from the development release, and do not represent the final product.

This looks awfully similar to the "Official Ubuntu Book"

  • It may bear some similarities to the Official Ubuntu Book, but these are purely by coincidence. We are creating this manual as a separate entity to the Official Ubuntu Book for a variety of reasons, one of these is cost. If you are an every day user and one of the reasons you are switching operating systems from Windows to Ubuntu because it is free, then would you go out and pay $35.99USD for a book on how to use it? Not to mention that for people who live outside the US, if you take in the currency conversion and shipping, it would cost a lot more than that. We're not trying to put down the Official Ubuntu Book - I'm sure it's an excellent book, and our manual will probably not have as much detail. Our manual is targeted at a different audience than the book.

What infrastructure have you got in place for this Project?

  • We use a combination of LaTeX, bzr and Launchpad to handle the core project files, as well as bug tracking, blueprints and answers.

Where is the Translation support?

Didn't this go by the name of the "Ubuntu Beginners Guide" for a while?

  • Yes it sure did - when I first started working on it I had that as a title. But I changed it to Ubuntu Manual for simplicity, and as a working title until we decide on the permanent title. It may just remain as "The Ubuntu Manual."

When will the first release be available?

  • The alpha release is scheduled to be ready on the 10th February, 2010.

Who is the Project Driver?

  • Benjamin Humphrey started this Project at the end of 2009. He has written several chapters as well as most of the wiki. He also maintains the Launchpad blueprints, bugs and branches, mailing list and IRC room, and organizes meetings. You are welcome to contact him directly, although it is best if you email the mailing list instead and address the email to Benjamin - unless it is confidential of course.

How can I contact someone in the Project?

  • There are multiple ways to contact us. The easiest is to email the mailing list, or join our IRC channel. All of these details can be found on the home page.

Where is the manual style defined?

  • Currently, the manual style is not defined in text, per se. It is available as a visual guide on the Project page downloads section in PDF format, for reference only.

Where is the writing style defined?

  • We do not have an explicit guide to follow - the best way to see how the manual is written is just to look at the completed chapters and use them as an example as to how you should write your chapter.

Who are your target audience, and for what reason do you expect them to read this manual? What is their level of technical ability?

  • The target audience is complete newcomers to both Ubuntu and Linux. People who have heard about it, and are interested in switching from Windows/Mac. Therefore the manual will give them a brief background of Linux and Ubuntu, and explain that it is not comparable to Windows or Mac - It's completely different. I know that when I started using Ubuntu, I knew nothing about man pages, or the Ubuntu Community Docs. Finding a specific Doc page was difficult, and in all honesty, many of the doc pages are written in a style that presumes you already know your way around. The system documentation, while easier to understand, is not as in-depth as it should be. This manual/book will be easy to understand, have everything in one place so its easy to find, it will be well advertised to new Ubuntu users and it will have everything in correct order, so that users learn how to do one thing before doing the next which relies on the former. Their level of technical ability ranges from complete computer newbie to someone who is familiar with Windows but never used Linux.

Who will be responsible for maintaining the document, and what sort of infrastructure will they be using to do that (i.e. translations, bug reports, version control)?

  • The Ubuntu Manual Team is in charge of maintaining the document, headed by Benjamin Humphrey. The infrastructure will be mainly based around Launchpad, IRC, Ubuntu Wiki and docbook.

How is the document licensed?

  • The document is licensed under Creative Commons - Attribution Share Alike.

Why did you choose the topics that you did?

  • The topics are based off several other Ubuntu manuals, the Community Docs, my own experience with Ubuntu, this thread and my blog post.

Did you carry out any research on the needs of your target audience? e.g. interviews, observation sessions, questionnaires.

  • Yes, see the above question.

Not so Frequently Asked Questions

How many keys are there on a keyboard?

  • Most keyboards have around 120 keys.

Who is Oleg Leonidovich Kryzhanovsky?

  • Oleg Leonidovich Kryzhanovsky was a Russian entomologist who specialised in Coleoptera; especially Carabidae and Histeridae.

When can I catch "Big Mama and the Wild Bunch" on WXKB?

  • From 6AM to 10AM every day.

What color are Benjamin's curtains?

  • In Dunedin, they're purple - they came with the flat where he lives while studying. In Christchurch, they are green.

Did Jesus have a middle name?

  • To be honest, I don't know.

2B or not 2B?

  • I think that's a grade of pencil.

If Barbie is so popular, why do you have to buy her friends?

  • Perhaps she has expensive tastes.

Who is General Failure and why is he reading my hard disk?

  • ..