I'm a bit slow this week with writing up the minutes, but here you go.
(Stored at
http://infoshare.sfbay/twiki/bin/view/Main/DocumentationforOpenSolaris#Agenda_and_Minutes)
Attendees:
Barbara Lundquist, Pattie Levinson, Jyothi Srinath, Kathy Slattery,
Kathleen Flaherty, Diane Plampin, Paul Kasper, Kelly Nishimura, Cindy
Swearingen, Dolores Eccles, Alta Elstad, Doug Stevenson, Clayton
Cornell, Doug Stevenson, Jasmine Ocegueda, Anjana Sriram, Mary Lautner,
Wenling Chen, Ben Rockwood.
Minutes:
* *AI Review*
o 2008.11 /Localization hand-off: Open. In progress. Alan
asked Kathleen to try finalize plan so we can close this
action by next meeting.
o GNOME desktop docs: Clayton has communicated via email that
the desktop group is integrating newer version of GNOME with
latest docs. (Build 99 has GNOME 2.23.91). Kathy Slattery
says she's intending to work with Clayton to see if any of
the OpenSolaris extensions (e.g., Visual Panels) info needs
updating as well. Will close this action item.
o Communicate deliverables to G11N. Alan confirmed with
Dolores that G11N has info it needs for its planning. Will
close this action item. Dolores have follow-up questions
regarding OSOL for Linux Admin and DTrace Examples work.
Alan confirmed with Diane that OSOL for Linux Admin is
probably going to be high-level info with pointers off to
other info. Dtrace Examples is a new doc.
* *Versioning of wiki content*
o Alan framed discussion.... there seems to be implicit
requirement that we produce a PDF version of any content
that is in wiki format. Questions: What are real
requirements for creating static version of a wiki-based doc
and what do we need to do to track to a release?
o Dolores said in other G11N doc efforts, they have just used
wiki commenting facility to identify the version of a doc
that they were using as the baseline for translation. She
also noted that a hard-copy/PDF is not a requirement. Kathy
Slattery noted that the genunix site may not have the
commenting facility. Alan to give Dolores a pointer and let
her take a look. (Done.)
o Alan asked again what's behind the compulsion to provide a
PDF snapshot of a wiki doc. Kelly thought there might be
reasons to do this for Support. (Paul Kasper noted that any
static copy should point to the "living" document as the
latest and greatest content, since a static copy could very
quickly be out of date. Alan noted there have been legal
requirements, specifically with regard to submitting
copyright requests with the federal government, which had to
be done for 2008.05. Kelly said she did not anticipate need
to do this for 2008.11. Only for major new releases. (Alan
cheered this news. smile Kathy wondered if there were any
other legal requirements. Alan to ask Legal. (Done -- Jeff
Osteen says that outside of the copyright filing scenario,
he knows of no requirement from legal that we produce a PDF)
o Cindy Swearingen noted that Solaris docs are currently
considered "continuously updated docs." Paul made reference
to a document that spells out procedural guidelines for
continuously updated docs. Shouldn't wiki-based docs be
viewed similarly? Alan asked Paul to share the guidelines
doc. (Done.)
o Kelly suggested we get inputs from Glynn Foster (Marketing).
Alan will follow up with Glynn.
o Kelly also asked how other distributions handle versioning.
Cindy and Alta did some lookups during and discussion and
reported the following:
+ Ubuntu - Documentation for Ubuntu
(https://help.ubuntu.com/) shows tabs to access
documentation for earlier releases. (Alan noted that
OpenSolaris
<http://infoshare.sfbay/twiki/bin/view/Main/OpenSolaris>
doc community site intends to provide access to both
current and previous releases. Will see first
iteration of this in 2008.11.) Note that there is a
"community docs" tab right next to the "release
version" tabs. Going to the wiki docs, it's unclear
what version of Ubuntu the community docs are intended
to support.
+ Fedora - provides a release summary to define features
documented.
o Alta brought up a peripheral issue about SXCE docs and their
updates. Alan to follow-up (and include Kelly, et al.) on
the issue.
* *2008.11 Status*
o Kathleen thinks doc specs are in (although subsequent
discussion highlighted that a few topics in spreadsheet did
not have accompanying doc specs. Kathleen trying to
reconcile those mismatches.)
o General status - code freeze occurred earlier in the week.
Several doc reviews out.
-alan
--
Alan McClellan
OpenSolaris Documentation Community Manager
#32171
+1 719-352-0993
http://blogs.sun.com/docexchange/
