Differences between revisions 48 and 94 (spanning 46 versions)
Revision 48 as of 2010-04-16 02:21:14
Size: 11986
Editor: humphreybc
Revision 94 as of 2013-08-24 20:43:53
Size: 1398
Editor: schlopo
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
== Next Meeting, 17 and 18th April, 2010 == == Upcoming Events ==
Line 8: Line 8:
There will be two meetings on the weekend of the 17th and 18th, a Manual meeting on the Saturday and a Quickshot meeting on Sunday. === Authors Due Date ===
The Ubuntu Manual Team has set September 19th, 2013 as the due date for all authors to complete changes to the Ubuntu manual. If you have not started authoring, please do so now! If you have completed authoring, please contact the editors of your section. Our goal is to complete all the sections BEFORE the due date so as to give the editors plenty of time to complete their task.
Line 10: Line 11:
=== Manual Agenda === == Meeting Notes ==
=== Current Meeting Notes ===
The logs from the meeting on Saturday, August 24th, are now available. Click [[|here]] for the text version, and click [[|here]] for the HTML version.
Line 12: Line 15:
[[ UTC]] on Saturday, the 17th April 2010 in #ubuntu-meeting on freenode. === Meeting Notes Archives ===
[[|Summaries from previous meetings]]
Line 14: Line 18:
 * Branch re-organization
 * Lucid 2nd edition release date
 * Maverick release dates
 * Plans for Maverick
== Other Info ==
[[|Official Ubuntu Manual Project release schedule for Saucy Salamander (13.10)]]
Line 19: Line 21:
=== Quickshot Agenda ===

This meeting will be for Quickshot and mainly focus around the [[|Etherpad]] and which features we want to try and include for this release.

 * Client
 * Server
 * Bug fixes
 * Road map
 * Any other business
 * Next meeting?

[[|2000 UTC on April 18th, 2010]] in #ubuntu-meeting (NB) on

== About Meetings ==

Optional "briefs" are held once a week on Saturday at 2000 UTC in #ubuntu-meeting 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.

== Summaries, from older to newer ==

=== 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

==== Agenda ====

 * 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

{{attachment:warning.png|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.

=== Meeting 30/01/10 ===

[[|30th January 2010 at 2000 UTC in #ubuntu-meeting on]]

==== Summary ====

 * We decided (vote: 9 for, 0 against) to create a new section in the prologue called "Conventions used in this publication" which should act as a sort of "key" to icons etc for the rest of the manual
 * Target audience wasn't completely decided on, but lots of conversation took place about it. For a rough idea of Ubuntu users' average age, we found [[|this thread.]]
 * Some words thrown around for the writing style: Not witty, but welcoming, clear, concise, FOSS = awesome, solid, trustworthy, capable, friendly yet professional
 * Title was undecided with two proposals receiving a count of 3 each, "The Ubuntu Manual" and "Getting Started with Ubuntu 10.04" - Decided to defer discussion to the mailing list for now.
 * Screenshots, points of action from now on:
  * Appoint a screenshot leader and a team
  * Create a new branch off the main trunk branch for screenshots
  * Be very, very, '''very''' selective when choosing screenshots
  * Use a consistent virtual machine image
  * PNG as the input format, JPG as output format possibly
  * 800x600 8 bit images
  * Screenshot taking will start on March 4th, the Lucid UI freeze
  * Possibly use placeholder images in the meantime, Kevin Godby (godbyk) was assigned to look into this
 * Alpha review: We're behind schedule, everyone needs to keep their "progress" up to date on their assigned blueprints. Need to make more progress on writing, only 10 days till alpha release.
 * Decided to freeze the writing at our Beta, March 18th. This should allow us some more time to fine tune the writing, do some major editing and then it should also give over a month for translations to catch up before Release Candidate.
 * Very latest manual PDF build can be found [[|here.]]

==== Agenda ====
 * Target audience
 * How/where/when will users come across our document?
 * What style/tone should we aim for, what should be the message both about our document and Ubuntu?
 * What should the title be?
   * (The) Ubuntu (10.04) Manual
   * The Ubuntu Manual for 10.04
   * Ubuntu (10.04) Quick Start Guide
   * Ubuntu (10.04): A Beginners Guide
   * A Beginners Guide to Ubuntu (10.04)
   * An Introduction to Ubuntu (10.04)
   * The Ubuntu Manual: A Beginners Guide for New Users (10.04) (suggested by Kelvin Gardiner)
   * Other suggestions
 * Handling screenshots ([[|UI freeze]] March 4th)
 * Change to beta release date to align with the Lucid beta
 * [[|This]]
 * We need to decide on a date for the writing freeze
 * Ilya Haykinson would like everyone who is writing a chapter to create a summary of their chapter on the wiki
 * [[|Alpha review]]

Recommended reading:

=== Project meeting 13/02/2010 ===

Full logs here:

==== Agenda ====

 * 48 Hours of Ubuntu Manual Learning
 * BETA Release milestones
 * Ubuntu Manual Global Jam
 * Artwork icons
 * T-t-title page!

==== Summary ====

 * Discussed timetabling of 48 hours of Ubuntu Manual - see for timetabling & edit if you need
 * Decided to create \screenshotTODO{description} command to insert placeholder and produce list of required screenshots
 * Discussion of Global Jam. Decided that it would be beneficial to promote translations and screenshots to be taken. Anybody near one was encouraged to go
 * Design team to produce mockups for chapter header icons
 * Title page not discussed without humphreybc and others
 * Use of serial commas throughout agreed
 * Kevin Godby to set up glossary system
 * Kevin Godby and Josh Holland to investigate creating daily localised builds
[[|Official OS release schedule for Saucy Salamander (13.10)]]

Upcoming Events

Authors Due Date

The Ubuntu Manual Team has set September 19th, 2013 as the due date for all authors to complete changes to the Ubuntu manual. If you have not started authoring, please do so now! If you have completed authoring, please contact the editors of your section. Our goal is to complete all the sections BEFORE the due date so as to give the editors plenty of time to complete their task.

Meeting Notes

Current Meeting Notes

The logs from the meeting on Saturday, August 24th, are now available. Click here for the text version, and click here for the HTML version.

Meeting Notes Archives

Summaries from previous meetings

Other Info

Official Ubuntu Manual Project release schedule for Saucy Salamander (13.10)

Official OS release schedule for Saucy Salamander (13.10)

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