Mike Kupfer <mike.kupfer at sun.com> writes: > The overall structure that you suggest makes sense to me. > >> Why: >> OpenSolaris, the gate needs to be outside, TeamWare doesn't fit such >> a model. (other benefits from mercurial go here? on another section?) > > I would spend as little time as possible on the "why". We went through > the SCM evaluation, the move to Mercurial is essentially a done deal, > let's not waste time rehashing the decision.
I was thinking very brief, to cover the people who'd managed to miss all of that, not much more than the text above on a slide, but true, everyone who'd be reading it should know already. >> What changes: >> High-level what's new, what's different, what's gone. >> tools, features, internal paths(?) > > I would focus on high-level changes in this section, and leave details > to the "what you need to do" section. Yes, the high-level in my text was intended to apply to everything in that section, not just the "What's new". >> Questions, pointers to tools-discuss, etc. > > We should set up one or more external web pages by the KTD (or soon > thereafter) with > > - high-level differences between Teamware and Mercurial > - Teamware -> hg cheat sheet (the "how do I do that now?" stuff, > probably in more detail than we have time for in the KTD) > - pointers to detailed documentation (e.g., the Mercurial wiki, Bryan > O'Sullivan's book) I think a few people already have such documents floating around Sun, we could probably borrow one of those, and expand it, if necessary (and move it outside, if it isn't, obviously) -- Rich
