On 7/2/07, John Maddock <[EMAIL PROTECTED]> wrote: > David Abrahams wrote: > > However: > > > > * long lines pose well-known and proven readability hurdles > > (http://psychology.wichita.edu/surl/usabilitynews/42/text_length.htm)
Ok. > > * Boost itself has a guideline that lines of code should be kept to > > within 80 characters > > Yep. Totally agree. > > * Ditto for being able to print PDFs of your documentation > > That's a whole other topic, but I'm going to suggest we standardise on A4 > paper sizes for our PDF's: A4 is an ISO std (unlike US letter) and in > practice is just slightly smaller all round than US letter, which should > keep folks on both sides of the Atlantic happy I hope! I think we should stick to ISO standards. +1 for A4. > > * Since line breaks are fixed in code, if code examples *do* follow > > the guidelines, a wide browser window really wastes a lot of space. > > Yet we are not using a fixed-width layout primarily because some > > people complain vociferously that we're preventing them from using > > screen real-estate efficiently. > > Like you I find long line lengths and large paragraphs almost impossible to > grok, especially if the font is small. However, I have to say that I find > multi-columns even worse, *unless* you can guarentee that everything fits on > one screen - even for folks reading on sub-mobiles with 8" screens or > whatever. Me too. I think that people that want to read with shorter lines can simply resize the browser's window. With respect to multicolumns, the page was really slow on my computer too, and at least for me more difficult to read than a normal page. Best regards Matias ------------------------------------------------------------------------- This SF.net email is sponsored by DB2 Express Download DB2 Express C - the FREE version of DB2 express and take control of your XML. No limits. Just data. Click to get it now. http://sourceforge.net/powerbar/db2/ _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
