Playbook One

Dougie Richardson dougierichardson at ubuntu.com
Sat Apr 25 10:12:20 UTC 2009


Hi Matthew,

2009/4/25 Matthew East <mdke at ubuntu.com>:
> Looks nice and clear.
>
> I agree with the comments that I've seen so far. Some quick comments
> late at night (mainly nitpicking...)
>
> 1. I don't think the use of "patch it" is quite correct. I think to
> "patch" something means to apply a patch. For simplicity, I think the
> last two sections could be combined to read "Post it" and can describe
> the process required to create and post a patch. That would also help
> to reduce the length of the catchphrase, which I think is a good idea
> but a bit too long for a catchphrase.  It could be reduced further by
> removing one of the verbs in the second step, so for example:
>
> "Get it, change it, check it, and post it!"

Yes I agree - that looks better.

> 2. I think you should say which Creative Commons license is applicable.

I will.

> 3. In the "Get it" paragraph, "its" should be "it's".

Fair one.

> 4. Same section, where you refer to a folder, it would be good to have
> the folder name ("po", or "C") in inverted commas, in the same way as
> you have done for "internet".

OK.

> 5. The first word on the second page should be removed, for popey's sake.
>
> (reference: https://lists.ubuntu.com/archives/sounder/2009-April/011654.html)

You weren't kidding about nitpicking ;-)

> 6. In the "Check it" section, I would start a new sentence after "good to go".

OK.

> 7. In the "Post it" section, you have two "and"s, I think it would
> read better with the first one as a comma.

OK.

> I think the next stage is for some new contributors to give it a test
> run and give some feedback about anything they found unclear or any
> additional information that they needed to know in order to get going
> with a simple fix.

I'll update from all the current suggestions and re-upload it.

-- 
Regards,

Dougie Richardson
http://www.lynxworks.eu/
dougierichardson at ubuntu.com




More information about the ubuntu-doc mailing list