Differences between revisions 17 and 18
Revision 17 as of 2010-01-17 23:43:52
Size: 6702
Editor: humphreybc
Revision 18 as of 2010-01-17 23:45:10
Size: 6774
Editor: humphreybc
Deletions are marked like this. Additions are marked like this.
Line 111: Line 111:

Line 125: Line 129:
{{attachment:warning.png|Warning Icon|align="left"}} {{attachment:warning.png|Warning Icon|}}
Line 140: Line 144:


Optional "briefs" are held once a week on Saturday at 1100 UTC in our own channel, #ubuntu-manual on

These short meetings are just to ensure that we're on track towards the milestone, and for anyone to raise any issues or questions they may have.

Because they're weekly, I don't expect everyone to attend each week - but try to get to as many as you can.

There will also be a larger meeting which will be held when we deem necessary - with lots of advance notification. These will usually occur around the time of releases, before them or straight after to plan the next release.

Meeting logs can be found at:

And also someone will create a summary of events which will be posted at the bottom of this page, as well as sent in the mailing list for those who couldn't make it.

Meeting Summaries

Project Meeting 02/01/2010

Full log can be found here:

Summary of important topics:

The new plain text method

Decided against using plain text. jmburgess suggested using LaTeX, other alternatives were also suggested. After some explanation of LaTeX and benefits, a vote was held on switching to LaTeX.

The vote was passed 10 in favour to 0 against.

Sourcing Images

Decided against using custom artwork for now. Need a list of screenshots that we want, which humphreybc is going to start compiling on the wiki. Decided that screenshots are very important, and that we cannot sacrifice any screenshots due to the translation of them being difficult.

Licensing of the manual

We looked into the licensing, decided that some variant of Creative Commons (CC) was most appropriate, but need to contact someone from the ubuntu-docs team to confirm which variant.

Approver for main release blueprints

This is going to be changed to the Ubuntu Manual Team instead of Benjamin Humphrey.

Overall Goals

Revised the overall goals (chapter two of the wiki) and decided they were satisfactory.

Kelvin Gardiner's feedback

See Kelvins feedback here:

We decided to explicitly split the manual into two parts, voted 7 for, 0 against. The first half will be aimed at complete newbies, the second half is for more advanced users.

Changes to the chapter order were also agreed upon, and chapter 8 and 10 will be merged together. Chapter order still needs to be refined, but this can be done over time.

Chapter 9: Useful Applications

Decided to remove Ubuntu Tweak because it's not in the repositories, and added Pitivi, Wine and the GIMP to the list.

Questions and Feedback

AnmolSarma asked about games - we decided to include a small paragraph near the end of the first half of the manual that lets users know there are a lot of games available in the repositories - and perhaps having an "Authors Picks" Top 5 list of good games or similar.

Also decided a short summary on Wine should be in Chapter 9.

Date and Time for next meeting

We decided that 1100 UTC on a Saturday suited most people, although Sunday might be better. For now, we decided to hold weekly optional briefs at this time, and then have full meetings when we deem it necessary. See the meetings chapter on this wiki for more detail.

Project Brief 09/01/2010

Full log can be found at In this meeting we discussed the rewrite of the the Table of Contents. The result of of which can be seen at bug #504668.

The main reasoning behind changing everything was to keep in line with the fact that we are aimed toward absolute beginner, who really don't want to touch the terminal. We have decided that the new ToC has a better flow as well as a better content spread.

The entire conversation is up on the bug comments.

Project Brief 16/01/2010

Saturday, 16th January 2010 at 1100 UTC/GMT in #ubuntu-manual on


  • Roll Call
  • Welcome to our new members
  • Changes since last meeting (new editing team, ToC, LaTeX stuff etc)
  • Style and content of margin notes
  • Style and content of in-line definition notes
  • Making the project more self-documenting
  • Format of the credits
  • Style of the footer - and header?
  • Font colours review
  • Indentation review
  • Page type - A4, US Letter, or both?
  • Screenshot and image resolutions and guide - captions? Figures?
  • Glossary format and assignee
  • Index and assignee
  • Chapter heading review
  • Title page proposals
  • Feedback from Ubuntu Forums questionnaire
  • Are we still on track?
  • Questions/Feedback

Meeting Summary

Meeting started at 1105 UTC.


The meeting had around 10 active participants to being with. Most of the meeting was discussing style and formatting of various parts of LaTeX. There was quite a bit of voting, here are the results:

Vote: "Should margin notes be exclusively used for cross references?" Result: 6 for, 2 against.

Vote: Warnings and IMPORTANT things are in the paragraph, with formatting to highlight the importance. Cross references and background info are in the margins. Remove in-line notes altogether. Final result is 10 for, 0 against. 0 abstained. Total: 10

Vote: Should the notes have colour? Final result is 0 for, 6 against. 0 abstained. Total: -6

Vote: Should the margin notes be on the right? Final result is 8 for, 0 against. 0 abstained. Total: 8

Warning Icon VOTE: Warnings should be in a paragraph, with an icon like the one above, that sits in the left margin, indented. Final result is 8 for, 0 against. 0 abstained. Total: 8

Self documenting: Decided to leave it as is, improve readme in the branch. Point to wiki for more info.

Credits: Three columns, no bullet points. Smaller font.

Footer: Number + chapter title on left, page number on right.

Vote: Font colours stay the same. Final result is 5 for, 0 against. 1 abstained. Total: 5

Decided we are on track. No further questions/feedback. Next meeting Saturday 30th January 2000 UTC.

Meeting ended at 1230 UTC.

ubuntu-manual/Meetings (last edited 2013-08-24 20:45:03 by schlopo)