DocumentationTeamMeetingSummary6

Differences between revisions 1 and 6 (spanning 5 versions)
Revision 1 as of 2005-07-01 01:01:47
Size: 525
Editor: adsl-57
Comment:
Revision 6 as of 2005-07-01 03:35:19
Size: 2571
Editor: adsl-57
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
=== Minutes of the 1st regular Ubuntu Documentation Project Team meeting, June 30, 2005 === == Minutes of the 1st regular Ubuntu Documentation Project (UDP) meeting, June 30, 2005 ==
Line 5: Line 5:
Active participants of the meeting: == Meeting participants ==
Line 17: Line 17:

== Meeting minutes per agenda ==

Note: Current status of UDP projects can be found in the DocteamProjects page

=== Completion of the StyleGuide ===

The UDP StyleGuide is currently being written by Jeff Schering, but he prefers to have members of the team to contribute to some sections of the book, since the team will adhere to it in writing current and future Ubuntu documentation. Sean Wheller has agreed to handle the Docbook section of the StyleGuide, while Jerome Gotangco will look into the section that involves writing for an international audience. Other team members who volunteered for the StyleGuide effort are Matt Galvin and Sean Quinn but did not specify on the sections they will work on but promised to look into it. Matthew East indicated that while he cannot work on the StyleGuide, he will review all current documents in svn in reference to the StyleGuide once it is completed.

As for the section on Grammar, Spelling and Punctuation, there were no volunteers at the moment, but people are free to write to whatever style at the moment and leave the editorial work and set a review period for all books. There was also a suggestion to adopt the [http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html Chicago Manual of Style] but since only a selected few of the team are familiar and have access to the said document (it is a bit pricey), there is no point of specifying it, although it can be used to resolve writing style disputes.

=== Doc Planning - creating document plan pages for our books ===

Jeff Schering suggested that all books under DocteamProjects should have a document outline/specification similar to what is written in the StyleGuide wiki page. He mentioned that ''"we need to know who we are writing for, and the purpose of the doc(ument)."'' Matthew East added that a page like this can greatly help newcomers who would like to contribute to the project. Sean Wheller reminded the group that this is already available in the current svn, and that it was an idea that never took off.

Minutes of the 1st regular Ubuntu Documentation Project (UDP) meeting, June 30, 2005

IRC log of the meeting is available: http://people.ubuntu.com/~fabbione/irclogs/ubuntu-meeting-2005-06-30.html

Meeting participants

IRC Nick

Full Name

jsgotangco

Jerome Gotangco

froud

Sean Wheller

mdke

Matthew East

mgalvin

Matt Galvin

hno73

Henrik Nilsen Omma

squinn

Sean Quinn

jeffsch

Jeff Schering

judax

Troy Williams

jdub

Jeff Waugh

Meeting minutes per agenda

Note: Current status of UDP projects can be found in the DocteamProjects page

Completion of the StyleGuide

The UDP StyleGuide is currently being written by Jeff Schering, but he prefers to have members of the team to contribute to some sections of the book, since the team will adhere to it in writing current and future Ubuntu documentation. Sean Wheller has agreed to handle the Docbook section of the StyleGuide, while Jerome Gotangco will look into the section that involves writing for an international audience. Other team members who volunteered for the StyleGuide effort are Matt Galvin and Sean Quinn but did not specify on the sections they will work on but promised to look into it. Matthew East indicated that while he cannot work on the StyleGuide, he will review all current documents in svn in reference to the StyleGuide once it is completed.

As for the section on Grammar, Spelling and Punctuation, there were no volunteers at the moment, but people are free to write to whatever style at the moment and leave the editorial work and set a review period for all books. There was also a suggestion to adopt the [http://www.press.uchicago.edu/Misc/Chicago/cmosfaq/cmosfaq.html Chicago Manual of Style] but since only a selected few of the team are familiar and have access to the said document (it is a bit pricey), there is no point of specifying it, although it can be used to resolve writing style disputes.

Doc Planning - creating document plan pages for our books

Jeff Schering suggested that all books under DocteamProjects should have a document outline/specification similar to what is written in the StyleGuide wiki page. He mentioned that "we need to know who we are writing for, and the purpose of the doc(ument)." Matthew East added that a page like this can greatly help newcomers who would like to contribute to the project. Sean Wheller reminded the group that this is already available in the current svn, and that it was an idea that never took off.

DocumentationTeamMeetingSummary6 (last edited 2008-08-06 17:00:45 by localhost)