GDP Release Committee Minutes

[Gregory Leblanc <gleblanc cu-portland edu>]

Minutes for the GDP Release Committee meeting Feb 18, 2001
----------------------------------------------------------

Present:
--------
Dan Mueth         (chair)
Gregory Leblanc   (minutes)
Telsa Gwynne
Kevin Breit
Kenny Graunke
Laszlo Kovacs
John Fleck
Alexander Kirillov (arrived 1:18) (departed 1:53)
Ali Abdin (arrived 1:45)

Absent:
-------


Regrets:
--------


Decisions:
----------

- Meeting time agreed to be at 1:00PM PT (9:00PM UTC) on Sunday for
  GDP Release Committee meetings.

- Gregory Leblanc will serve as secretary at meetings

- User's Manuals for applications should be kept in the
  '<application>/help/<locale>/*' sub-directory in CVS, and figures,
  screen shots, and other graphics should go into
  '<application>/help/<locale>/figures'.

- Maintainers assigned for coordinating documentation in various
  modules for the GNOME 1.4 release.  This involves maintaining an
  idea of what the status of a particular module's documentation is
  in, and being a liaison between the docs writers and the application
  hackers.

  - ggv -- John Fleck
  - gnome-applets -- Telsa Gwynne
  - gnome-core -- Dan Mueth
  - gnome-utils -- John Fleck
  - gnome-games -- Gregory Leblanc
  - nautilus -- Dan Mueth
  - ghex -- John Fleck
  - control-center -- Alexander Kirillov
  - bug-buddy -- Telsa Gwynne
  - dia -- Kevin Breit

- Future GDP Release Committee meetings will be open to all GNOME
  members.  This meeting was held without general publication to
  ensure that we could schedule a time for regular meetings, and to
  ensure that the meeting was as effective per time spent as
  possible.  Kevin Breit will be coordinating the Quality Assurance
  efforts for the GDP durring the GNOME 1.4 timeframe.

Work Done:
----------
Since this is our first meeting, we haven't finished any work since
the last meeting.


Work in Progress/To Be Done: 
---------------------------- 

- TODO: Dan Mueth -- Draft note to the hackers informing them that in
  order to build gnome packages with have OMF from source and have the
  OMF data installed properly, scrollkeeper-preinstall must be
  available.  This means that you need to have Scrollkeeper installed
  before building packages for distribution.

- TODO: Dan Mueth -- put HACKING files into gnome-user-docs and
  gnome-devel-docs, and to inform gnome-hackers about the new modules
  and refer them to the HACKING files for further information.

- TODO: Alexander Kirillov -- gather a list of documentation that is
needs to
  be moved into gnome-user-docs, and to email this to Gregory Leblanc
  <gleblanc cu-portland edu>
- TODO: Gregory Leblanc -- move documentation into the new
  gnome-user-docs module, after clarifying the correct procedure for
  moving docs in CVS with Martin Baulig, or another vetran hacker.

- TODO: Telsa Gwynne -- create a gnome-user-docs product in bugzilla.
  Alexander Kirillov and Telsa Gwynne would like to work on these
  docs, but has more to do than she can handle already, so this will
  wait for now.

- TODO: Gregory Leblanc -- gather a list of the packages included in
  the GNOME 1.4 core and extra-apps distributions which need GDP
  coordinators.

- INFORMATION: John and Ali reported on the status of gnome-db2html2.
  gnome-db2html2 is mostly solid, with only a few minor known-bugs
  left.  Indexing support isn't included yet, and there is not enough
  time to get it added before 1.4.  Strings have been marked for
  translation, so navigation should appear in the user's specified
  language.  Ali would like to have the navigation links that are
  generated match the locale of the doc, rather than the locale that
  the user has set, but this isn't written yet.  The status of
  Japanese in gnome-db2html2 is -unknown-.

- TODO: John Fleck and Dan Mueth -- test i18n in gnome-db2html2

- TODO: Dan Mueth -- follow up on the bugs with HTML Help in Nautilus.
  Bugs #4302,* #5945, and#6761 in the Nautilus bug system.

- TODO: Dan Mueth -- have Jacob Berkman patch gnome-libs to make
  nautilus the default help browser.

- TODO: Ask Arik to do the "font stuff" for the help sidebar in
  nautilus.

- TODO: Dan Mueth -- enable ScrollKeeper for the help sidebar in the
  default build of Nautilus, including hourly RPMs.

- TODO: Telsa Gwynne-- create a "documentation" component for any
  products in bugzilla which don't already have one.  Kevin Breit to
  be the default contact on these products.  Telsa will also try to
  find and kill the products which are using some component other than
  "documentation".

- TODO: Kevin Breit -- develop test assertions, and document
  this procedure so that it can be applied for GNOME 1.4

- TODO: Kevin Breit -- divide docs into groups for QA volunteers to
  sign up for.

- TODO: Laszlo Kovacs-- repair locale fallback for ScrollKeeper in time
for
  GNOME 1.4.  

- INFORMATION: Scrollkeeper will need to be installed on end user
  machines to make the help sidebar in nautilus work properly.  People
  who build packages including OMF metadata should install
  ScrollKeeper so that the document metadata is included in the
  package.  ScrollKeeper can be obtained from:
  http://sourceforge.net/project/showfiles.php?group_id=11543&release_id=24049

- TODO: All Package Coordinators -- gather a list of docs that have
  been completed recently, and are now "frozen".  Mail this list to
  Dan Mueth on Thursday, and he'll collect it and post it to the
  gnome-i18n mailing list.  This is a weekly -recurring- task.

- TODO: Telsa Gwynne -- talk to the i18n team and get feedback on what
  the GDP can do to make translating documentation easier.

- TODO: Dan Mueth -- Mail gnome-hackers to inform them that all gnome
  tarballs that include GDP docs need to include a COPYING-DOCS file
  which contains the GNU Free Documentation License in plain text
  format.  It should be installed along side the COPYING file, which
  should contain the license for the package (GPL/LGPL)


Agenda Items Left For Next Meeting:
-----------------------------------

- User's Guide to be left until the next meeting.  Please review the
  mail by Dan, and prepare for the test at the next meeting.  :)

- Review the list of unfinished documents.

- Discuss use of Bugzilla for the GDP further.

Agenda:
-------
1) Set time for next meeting
2) Minutes
3) Discuss status of gnome-user-docs
4) Discuss gnome-developer-docs and developer FAQ
5) Discuss GNOME Users Guide
6) Review which packages do not have doc maintainers for the GNOME 1.4
release
7) Discuss status of gnome-db2html2
8) Review status of converting docs to work with Nautilus
9) Review status of OMF/ScrollKeeper
10) Review QA plan
11) Review list of unfinished documents
12) Plan for freezing docs and passing them to translators (Release a
weekly list of docs which are frozen and ready for translations?  Stage
docs so each week we completely review and freeze some docs.)
13) Opening up meetings (I don't want the meetings to seem exclusive,
although it makes scheduling a heck of a lot easier if you have a finite
number of people, and the meetings are a lot more efficient. Let's
discuss
having these be open meetings though after we get a schedule locked
down.)