On Mon, 19 Jun 2006, Michelle Olson wrote: > Hi Frank, > > Had time to look at your blogs today and the content is really cool. It > sounds like a great gap to fill WRT how things can be done and would be > useful as a learning series. But, something we should also send around > for discussion. > > I really like the small set of articles so far and I'm happy to post > them on the Doc Reviews page with the same caveats and disclaimers you > have identified. Then, I think we could get the right aliases reviewing > the content with a few posts to related lists. For format, you could > just put all the HTML into one file, I think, since they are so short. > > I like a series of blogs because it gives a sense of time and order, but > if you use headings to indicate that order in one file, you preserve the > flow for the reader. Let us know what you want to do, send along the > files for posting, etc. , and we can get started with reviews. > > Regards, > Michelle
Hi Michelle, hi all, thanks for the feedback - sorry for my late response ... To address some of the points (picking Michelle's mail for a reply quote, but also talking about what Eric said): Using docbook/SGML for this and turning it into book-style; assuming I'd go for this, is it possible to embed hyperlinks, both to other sections of the article series and to actual sourcecode on cvs.opensolaris.org ? On reviewing, cut&pasting it all from the blog entries into a single file makes it very hard to maintain for me (and doubly hard to split up again afterwards). My UNIX-utils-for-textprocessing knowledge is a bit stale - does anyone know a simple preprocessor that substitutes nothing but '#include "...."' so that I can create the "all in one" file/TOC simply by concatenating the sections ? What would I use ? Maybe I should just shellscript that ... Another option might be to (ab-)use the genunix.org OpenSolaris Wiki and put the articles there. What do you folks think about that idea ? Wiki would be a simple way for change tracking and article review ... Thanks to everyone who's responded so far ! FrankH. ============================================================================ No good can come from selling your freedom, not for all gold of the world, for the value of this heavenly gift exceeds that of any fortune on earth. ============================================================================
