Hi Rainer, Thanks for this message, I missed my Friday goal to have the new style guide ready, will get it out this week. Keep 'em coming!
I believe this verison will be a justified Beta, thanks to your efforts and detailed review feedback. Sorry for this delay, but I will be able to inc all changes from last week into the new version, since I'm being slow. For those things that we are only starting (like writing conceptual descriptions and audience analysis), I will create placeholders and we can draft those smaller pieces in email on the alias if needed. Thanks again, Michelle >X-Original-To: docs-discuss at opensolaris.org >Delivered-To: docs-discuss at opensolaris.org >Date: Fri, 03 Feb 2006 14:02:47 PST >From: Rainer Heilke <rheilke at dragonhearth.com> >To: docs-discuss at opensolaris.org >Mime-Version: 1.0 >Content-Transfer-Encoding: 7bit >Subject: [docs-discuss] Re: Another internal doc >X-BeenThere: docs-discuss at opensolaris.org >X-Mailman-Version: 2.1.4 >List-Id: General documentation discussion and requests to contribute documentation <docs-discuss.opensolaris.org> >List-Unsubscribe: <http://mail.opensolaris.org/mailman/listinfo/docs-discuss>, <mailto:docs-discuss-request at opensolaris.org?subject=unsubscribe> >List-Archive: <http://mail.opensolaris.org/pipermail/docs-discuss> >List-Post: <mailto:docs-discuss at opensolaris.org> >List-Help: <mailto:docs-discuss-request at opensolaris.org?subject=help> >List-Subscribe: <http://mail.opensolaris.org/mailman/listinfo/docs-discuss>, <mailto:docs-discuss-request at opensolaris.org?subject=subscribe> > >May as well put this post here, too... > >On pages 157 through 159, there are numerous mentions of various departments, meeting company editorial guidelines, managers, etc. The term "customer" is also used a few times, which should maybe become a generic "reader". (?) > >Will OpenSolaris document contributors write BluePrints articles? > >Under Training Documents, there is this sentence: > >>These materials might include a student guide, an instructor guide, which >>consists of the student guide plus additional notes, overheads, workbooks, and >>studyguides. > >I would recommend removing the comma after "instructor guide", or rephrasing the statement (especially if I'm reading it incorrectly). It just seems a bit awkward. <shrug> Also, studyguides is choking the spell checker (no space). > >I'm thinking some of the categories under Other Training Documents (p.160) may not be applicable (like the TBT and WLC items), but I don't know. Perhaps the OpenSolaris site may be expanded in the future to allow these sorts of things? It could be an interesting idea, though it may conflict with a current revenue source for Sun. > >Sorry, Michelle, I had hoped to get to this area before you were prepping the next version of TSG, but I got pretty busy yesterday. > >Rainer >This message posted from opensolaris.org >_______________________________________________ >docs-discuss mailing list >docs-discuss at opensolaris.org
