Hi Rainer, Thanks for your feedback. You have quite the eagle eye. See my replies inline.
Alysson Rainer Heilke wrote: >Greetings. > >Well, this is a day or two early for me, so it only makes it a week late. My >apologies. [AT] No apologies needed. I'm just happy to get your feedback. :-) >In keeping with the minimal changes made, I have minimal comments. :-) It's >looking pretty darn good. > >I'm guessing the Tables page is a placeholder, for when the whole doc gets >stitched back together. [AT] Yep. You're right. It's an artifact of generating just one chapter. It'll be fine once the whole book is published. >Why is Example 4.1 an example, but all the others aren't? (Does this comment >make sense to you? If not, I can clarify.) [AT] Good catch. And I don't have a good answer. I think it would be best if I just removed the example tagging from that one example so that the inconsistency goes away. >page 9, first sentence has bolded words. Is this intentional, in the context >of your comment around bold for key words and text? This is also in the first >sentence of the About These Guidelines section. [AT] Another good catch. I'll use italics, instead of bold, to make those words stand out. Since we're no longer using bold for emphasis, that makes the most sense. >page 9, first sentence in About These Guidelines refers to a web browser. I >assume this one was just missed? [AT] Yes, thanks for catching it. >page 9, About... second paragraph. I'm assuming the intended underlining got >hosed by the change management. [AT] Yep. The underscores are actually there, even though you can't see them. >pp 11 & 12 refer to items on other pages, without the page numbers. Link >breakage? [AT] This is what happens when I generate a chapter and within that chapter are links to content in other chapters. It'll be fine once the whole book is published. >page 12, Man Pages refers to SunOS. Should this be changed to OpenSolaris? Or >a more generic reference made? [AT] Good question. Let me look into this and get back to you. >Good addition to the Index. > > >Gee, that's really all I see. Like I say, it looks pretty good. [AT] Thanks, Rainer. :-) >Again, my apologies for the tardiness. I'll try to be on time for the next >review. [AT] I intend to submit the next chapter for review within the next week. It is the procedures chapter, and it has a lot of changes. We can go with a longer review period, if that would help. I appreciate your feedback and want to give you plenty of time. This message posted from opensolaris.org
