← Back to team overview

ubuntu-manual team mailing list archive

Re: Comments on the Prolog

 

Hi Wendy,

No problem at all - better to not overcommit yourself than take on too much
then wish you hadn't!

It's probably more important at this stage that you help out with writing
the content if you are happy to stick with that. We are behind on content at
the moment and need as much help in that area as we can get. Then, if you
have time and the inclination later, you can always help out with
proofreading some pages like you did the other day.

I won't assign you as editor to any chapters for now, so feel free to just
concentrate on writing. If you're not comfortable with bzr/launchpad to edit
the source files, and don't feel that you have the time to get up to speed,
you can always send anything you have written or proofread to myself (or one
of the other admins), and we can put your work into the source files for
you.

All the best,

Jamin

On Sun, Jan 31, 2010 at 12:48 PM, Wendy Sheridan <
wendy@xxxxxxxxxxxxxxxxxxxxxx> wrote:

> Hi Jamin,
>
> I don't know that I can commit to being responsible for an entire chapter
> right now, (I've got a full-time job and a family and some other community
> work that I do). Ilya has given me some piece of chapter 2 to get my feet
> wet and get up to speed. Once I get to that point, I'll be more comfortable
> taking an editorial role for an entire chapter. If you need someone to
> "simply" proofread, similar to what I've already done (and not get into the
> source files), I can give a lot more pages a once over. To be honest, it
> will probably take me most of the next 2 weeks to get up to speed on all
> your tools, as I'm unfamiliar with all of them.
>
> If I can be put to better use doing proofreading/editing for the current
> release, I'm happy to do so. Otherwise, I'll do the sections that Ilya
> assigned to me this week, which was this:
>
> "I think something that is smallish enough that you could help would be a
> portion of the "Around your desktop" chapter.
>
> Currently we'll need a section there that's kind of as follows:
>
>    - Customizing your desktop
>       - Appearance
>       - Windows
>       - Screensaver
>    - Accessibility
>       - Assistive technologies"
>
> I will be loading the 10.04 alpha on a VM probably tomorrow (if not
> tonight), and I'll use the Manual for instructions (and let y'all know how
> that turns out).
>
> I don't want to say "no" to you right off the bat, but I also don't want to
> commit to something that I can't deliver. I'll know better in a few days or
> so. (This is my first Open source project - I'm going for a toe in the water
> first, instead of jumping in the deep end).
>
> Best,
> Wendy
>
>
> On Sat, Jan 30, 2010 at 6:48 PM, Jamin Day <jaminday+ubuntu@xxxxxxxxx<jaminday%2Bubuntu@xxxxxxxxx>
> > wrote:
>
>> Hi Wendy,
>>
>> Thanks for your comments and feedback. I have just had a quick look at the
>> pdf and think many of the changes you suggested are excellent, so I will go
>> through and make some necessary alterations. There has been one major edit
>> of the prologue so far but it is still a work in progress so we rely on
>> people like yourself to provide us with helpful feedback such as this. I
>> noticed your first comment about being verbose - on reading back through I
>> do agree and will try and slim it down a little without losing any important
>> content. Early sections like the prologue and first couple of chapters are
>> likely to be where people start, so we need to get it right so we don't lose
>> them!
>>
>> Regarding your comments on "Is Ubuntu Right For You" - I think your
>> insight here is great. However I will leave it up to Benjamin, the content
>> writer for this chapter, to go back and make any changes to that bit based
>> on your feedback.
>>
>> Ideally we need to get you up and running with bzr if you are not yet
>> already. That will allow you to make minor changes to the source files as
>> you go (e.g. fixing spelling/punctuation mistakes). Any bigger changes
>> should be suggested to the allocated writer/editor for that chapter just
>> like you have done now, and then collaborated on from there. We don't have a
>> set protocol for doing this yet though, which is something we need. I'll
>> have a think and also chat to Benjamin and anyone interested on the best way
>> to do that so it's consistent across chapters. If you need a hand with bzr
>> check out our wiki page under "Technical Help" or just ask one of us.
>>
>> Lastly, how would you feel about being the assigned editor for a chapter
>> or two? You obviously have a lot of experience in this area and have given
>> some great feedback already. We currently need an editor allocated to
>> chapters 6 and 10. Basically being allocated to a chapter means you are
>> responsible for liaising with the allocated writer for that chapter to
>> ensure it gets completed and reviewed/edited thoroughly. You can still
>> provide editing feedback on any of the other chapters such as you have done
>> today - it's more so we have a point person for each chapter responsible for
>> editing.
>>
>> Regards,
>>
>> JaminDay
>>
>> PS - You are correct, we are aiming for US English. However I'm from
>> Australia and Benjamin from New Zealand, so it's highly likely there are
>> words in the prologue we forgot to Americanize as we went!
>>
>>
>>
>> On Sun, Jan 31, 2010 at 9:54 AM, Wendy Sheridan <
>> wendy@xxxxxxxxxxxxxxxxxxxxxx> wrote:
>>
>>> Hi,
>>> I attached a truncated PDF (of mostly just the prolog - the Acrobat
>>> delete pages function is acting strange with this file - something to do
>>> with the Roman numerals and my counting skills apparently) with comments and
>>> editorial suggestions for the prolog. I also fixed a lot of punctuation
>>> errors (proper use of apostrophes go a long way towards meeting the
>>> "professional" goal).
>>>
>>> My edits were mostly to change some word choices to American English
>>> (which is what I know) - if those are not where you want to go, that's fine.
>>> I also deleted things that looked like slang and tried to tighten up the
>>> language a bit.
>>>
>>> The section "Is Ubuntu Right For You?" I think has some serious tone
>>> issues - all it tells me is that it's not going to run any of the software
>>> that I am used to and know and it seems to be actively dissuading me from
>>> wanting to use it (trying to put my "target market" hat on for a moment). I
>>> would strongly suggest shortening the negative bullet paragraphs, and don't
>>> snark at people who (like me!) *like* Adobe software (and have invested
>>> quite a bit of money in it in order to, for example, WORK to feed their
>>> family). For EVERY negative, IMMEDIATELY follow it with a solution/positive.
>>>
>>> Something like:
>>>
>>> * You probably aren't going to be able to call on your local computer
>>> store for help if you experience a problem. Luckily, because Ubuntu is
>>> community-based, open source software, the Ubuntu community is available
>>> on-line 24/7 and you will be able to find help and support from them (etc or
>>> something like this)
>>>
>>> * Ubuntu doesn't run most (or all?) Windows-based commercial software.
>>> However, the open-source community has created software that performs all
>>> the common tasks and functions that you typically use (and list them, with
>>> links to more info or downloads or whatever).
>>>
>>> * Ubuntu is also not a supported OS for many popular, commercially
>>> produced games (yet). However,  blah blah blah.
>>>
>>> And then you should list some more benefits for using Ubuntu.
>>>
>>> I have to get to some other things today so I can't do more right now. I
>>> hope I haven't ruffled any feathers. I also know I'm probably not following
>>> the right processes for this yet. Please bear with me as I figure out this
>>> whole system.
>>>
>>> Best,
>>> Wendy
>>>
>>> --
>>> Wendy
>>> ---
>>> wendyshandmade.etsy.com
>>> www.wendysheridan.net
>>> www.sheridanmultimedia.com
>>> www.twitter.com/wendydesigns
>>>
>>> _______________________________________________
>>> Mailing list: https://launchpad.net/~ubuntu-manual<https://launchpad.net/%7Eubuntu-manual>
>>> Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
>>> Unsubscribe : https://launchpad.net/~ubuntu-manual<https://launchpad.net/%7Eubuntu-manual>
>>> More help   : https://help.launchpad.net/ListHelp
>>>
>>>
>>
>
>
> --
> Wendy
> ---
> wendyshandmade.etsy.com
> www.wendysheridan.net
> www.sheridanmultimedia.com
> www.twitter.com/wendydesigns
>

Follow ups

References