I believe the sidebar contents is overused as well. I'm not sure we have a solid understanding of when the sidebar should be used. Some use it to reference other materials/websites; others use it to add more detail to the paragraph.
If we're writing our paragraphs correctly, all pertinent content should be in the paragraph only. I would suggest we only use the sidebar to define terms, much like a textbook does. On Sun, Aug 26, 2012 at 1:25 PM, John Cave <[email protected]> wrote: > One thing I have noticed about the manual, being relatively new to the > team, is that we use technical terms a little too often. For example, > instead of maybe saying "your settings are fetched from Ubuntu One" we > might say "please wait while your settings are downloaded from Ubuntu's > server farms". We definitely have improved, but I really noticed it when > I started writing my section :) > > John C > > On Sat, Aug 25, 2012, at 10:32 AM, Patrick Dickey wrote: > > In reading her review, I have to ask, would it make sense to move some > > of the things from the Prologue into an Epilogue or at least a later > > chapter? Specifically the things she called attention to (the Ubuntu > > Philosophy and History, Contact Details and About the Team) Maybe keep > > the History and Philosophy, but see if we can liven them up a bit. > > > > Also, I do agree with her about the sidebar text size. I didn't really > > pay attention to it before, but it is small. I wonder if all of the text > > could be increased by one size (or at least the body text--not so much > > the headings). > > > > Have a great weekend.:) > > Patrick. > > > > > > On Sat, 2012-08-25 at 02:49 -0500, Kevin Godby wrote: > > > Hello, everyone. > > > > > > Robin Catling (of Full Circle) has written a nice review of our manual: > > > > > > < > http://catlingmindswipe.blogspot.com/2012/08/review-ubuntu-manual-project-getting.html > > > > > > > > I recommend reading it and thinking about what we can/should do to > > > improve our manual based on this feedback. > > > > > > If anyone has seen other reviews of our (recent) manual, feel free to > > > post them to this thread. It'd be nice to get an idea of what people > > > think we do well and how we could improve. > > > > > > --Kevin > > > > > > _______________________________________________ > > > Mailing list: https://launchpad.net/~ubuntu-manual > > > Post to : [email protected] > > > Unsubscribe : https://launchpad.net/~ubuntu-manual > > > More help : https://help.launchpad.net/ListHelp > > > > > > _______________________________________________ > > Mailing list: https://launchpad.net/~ubuntu-manual > > Post to : [email protected] > > Unsubscribe : https://launchpad.net/~ubuntu-manual > > More help : https://help.launchpad.net/ListHelp > > > -- > Feel for the electrons that gave their time to delivering this message > to you. > > _______________________________________________ > Mailing list: https://launchpad.net/~ubuntu-manual > Post to : [email protected] > Unsubscribe : https://launchpad.net/~ubuntu-manual > More help : https://help.launchpad.net/ListHelp >
_______________________________________________ Mailing list: https://launchpad.net/~ubuntu-manual Post to : [email protected] Unsubscribe : https://launchpad.net/~ubuntu-manual More help : https://help.launchpad.net/ListHelp
