Writing Spaces - Web Writing Style Guide
Total Page:16
File Type:pdf, Size:1020Kb
WRITING SPACES - WEB WRITING STYLE GUIDE Matt Barton, James Kalmbach, & Charles Lowe et al. About this Book About The Writing Spaces Web Writing Style Guide was created as a crowdsourcing project of Collaborvention 2011: A Computers and Writing Unconference. College writing teachers from around the web joined together to create this guide (see our Contributors list). The advice within it is based on contemporary theories and best practices. While the text was originally written for students in undergraduate writing classes, it can also be a suitable resource for other writers interested in learning more about writing for the web. This document is available as a web text for reading online, a printer-friendly PDF, and an EPUB ereader version. Visit http://writingspaces.org/wwsg to learn more. Matt Barton, James Kalmbach, & Charles Lowe et al. 1 9/7/2021 https://human.libretexts.org/@go/page/42978 Book: Writing Spaces - Web Writing Style Guide Contributors Contributors and Attributions The following people contributed text, revisions, and/or copy edits to the Writing Spaces Web Writing Style Guide: Susan E. Antlitz, South University Online Matt Barton, St. Cloud State University Colin Charlton, University of Texas-Pan American Dennis G. Jerz, Seton Hill University James Kalmbach, Illinois State University Virginia Kuhn, University of Southern California Charles Lowe, Grand Valley State University Cedrick May, The University of Texas at Arlington Patricia A. McCabe-Remmell, Technical Writer for Aslan Document Management Services Craig A. Meyer, Ohio University Rick Mott, Eastern Kentucky University Holly Pappas, Bristol Community College James P. Purdy, Duquesne University Jim Ridolfo, University of Cincinnati Kyle D. Stedman, University of South Florida Pavel Zemliansky, James Madison University Elizabeth D. Woodworth, Auburn University at Montgomery Matt Barton, James Kalmbach, & Charles Lowe et al. 1 9/7/2021 https://human.libretexts.org/@go/page/42979 This text is disseminated via the Open Education Resource (OER) LibreTexts Project (https://LibreTexts.org) and like the hundreds of other texts available within this powerful platform, it freely available for reading, printing and "consuming." Most, but not all, pages in the library have licenses that may allow individuals to make changes, save, and print this book. Carefully consult the applicable license(s) before pursuing such effects. Instructors can adopt existing LibreTexts texts or Remix them to quickly build course-specific resources to meet the needs of their students. Unlike traditional textbooks, LibreTexts’ web based origins allow powerful integration of advanced features and new technologies to support learning. The LibreTexts mission is to unite students, faculty and scholars in a cooperative effort to develop an easy-to-use online platform for the construction, customization, and dissemination of OER content to reduce the burdens of unreasonable textbook costs to our students and society. The LibreTexts project is a multi-institutional collaborative venture to develop the next generation of open-access texts to improve postsecondary education at all levels of higher learning by developing an Open Access Resource environment. The project currently consists of 13 independently operating and interconnected libraries that are constantly being optimized by students, faculty, and outside experts to supplant conventional paper-based books. These free textbook alternatives are organized within a central environment that is both vertically (from advance to basic level) and horizontally (across different fields) integrated. The LibreTexts libraries are Powered by MindTouch® and are supported by the Department of Education Open Textbook Pilot Project, the UC Davis Office of the Provost, the UC Davis Library, the California State University Affordable Learning Solutions Program, and Merlot. This material is based upon work supported by the National Science Foundation under Grant No. 1246120, 1525057, and 1413739. Unless otherwise noted, LibreTexts content is licensed by CC BY-NC-SA 3.0. Any opinions, findings, and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the National Science Foundation nor the US Department of Education. Have questions or comments? For information about adoptions or adaptions contact [email protected]. More information on our activities can be found via Facebook (https://facebook.com/Libretexts), Twitter (https://twitter.com/libretexts), or our blog (http://Blog.Libretexts.org). This text was compiled on 09/28/2021 Credits A special thanks to Michael Day for his contributions in developing the idea for the Web Writing Style Guide. Writing Spaces also would like to thank our partners at Parlor Press, WAC Clearinghouse, and Grand Valley State University’s Sustainable Community Development Initiative for their continued support of Writing Spaces. The Web Writing Style Guide is hosted on the Writing Spaces’s website using Drupal, an open source content management system. The RSS icon in the What the Hell Is RSS? section is © Bharath Prabhuswamy and is from his Android Icons Set 2. Matt Barton, James Kalmbach, & Charles Lowe et al. 1 9/7/2021 https://human.libretexts.org/@go/page/43007 TABLE OF CONTENTS The Writing Spaces Web Writing Style Guide was created as a crowdsourcing project of Collaborvention 2011: A Computers and Writing Unconference. College writing teachers from around the web joined together to create this guide. The advice within it is based on contemporary theories and best practices. While the text was originally written for students in undergraduate writing classes, it can also be a suitable resource for other writers interested in learning more about writing for the web. ABOUT THIS BOOK CONTRIBUTORS CREDITS INTRODUCTION LICENSING TITLE PAGE1 1: INTRODUCTION 1.1: I KNOW HOW TO WRITE PAPERS. DOES ANY OF THAT STUFF APPLY ONLINE? 1.2: WHAT’S THE SAME WHEN WRITING FOR THE WEB? 1.3: WRITING FOR THE WEB - WHAT’S DIFFERENT? 1.4: WHAT WILL I FIND IN THIS GUIDE? 2: WRITING IN THE GENRES OF THE WEB 2.1: WHAT IS A BLOG? WHAT ABOUT TUMBLR? WHAT ABOUT TWITTER? ARE “NOTES” ON FACEBOOK THE SAME AS A BLOG? 2.2: TWITTER ONLY GIVES ME 280 CHARACTERS!? WHAT THE HECK? 2.3: WHAT IS A WIKI? IS IT A BLOG? 2.4: WHAT ARE REDDIT AND DIGG? 2.5: HOW CAN FACEBOOK HELP TO PROMOTE MY WEB WRITING? 2.6: WHAT THE HELL IS RSS? 3: THE RHETORICS OF WEB PAGES 3.1: HYPERLINKS ARE THE “TUBES” OF THE INTERNET 3.2: PAGE TITLES, HEADLINES, AND SUBHEADERS, OH MY! 3.3: DAMNIT, JIM, I’M A WRITER, NOT A GRAPHIC DESIGNER! (OR, WHO GIVES A CRAP?) 3.4: YOU CAN’T WRITE FOR THE WEB WITHOUT WORKING WITH VISUALS 3.5: WTF (WHY THIS FONT?) 3.6: HOW CAN I USE VIDEO ON MY SITE? 3.7: JAZZING UP YOUR WEB PAGES - THE GOOD, THE BAD, OR THE UGLY? 3.8: NOT EVERYONE CAN SEE YOUR GRAPHICS 3.9: IT’S NOT PLAGIARISM IF IT’S ON THE WEB, RIGHT? 3.10: PICTURES DON’T COUNT, RIGHT? 3.11: IN THE END, IT’S ALL ABOUT THE CODE BACK MATTER APPENDIX RESOURCES INDEX GLOSSARY 1 9/28/2021 Introduction Introduction Who is this style guide for? You! Well, to be more specific, it’s for anyone interested in learning more about web writing. It’s not intended to be a general book about writing—we’re focused here on the type of writing people do in social media sites such as blogs, wikis, Twitter, and more. We also have a section about the issues you face when you create web pages, whether on your blog, your wiki, or your own website. We’re tailoring it for college students, so we’re not using terms like “deconstruction” or “hybrid narrative” here. Nor will we tell you much about how to do things with software. Our focus is on the rhetoric of writing on the web—how to write things that people will actually want to read. We had fun writing this, and we hope you’ll have fun reading it. Enjoy! Matt Barton, James Kalmbach, & Charles Lowe et al. 1 9/7/2021 https://human.libretexts.org/@go/page/42982 Licensing Licensing The Writing Spaces Web Writing Style Guide, Version 1.0 (http://writingspaces.org/wwsg/title), is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. The Writing Spaces’s interpretation of “non-commercial” use is that users may not sell, profit from, or commercialize Writing Spaces’s texts. Determination of commercial vs. non-commercial purpose is based on the use, not the user. Read morein our Terms of Use. If you wish to copy, modify, or redistribute this text, you must (a) include this license, (b) attribute the Writing Spaces project, and (c) if you revise the text, clearly note that your version is a revision of the original. Matt Barton, James Kalmbach, & Charles Lowe et al. 1 9/7/2021 https://human.libretexts.org/@go/page/42981 Title Page1 Writing Spaces Web Writing Style Guide Version 1.0 Edited by Matt Barton, James Kalmbach, and Charles Lowe A Writing Spaces & Parlor Press Open Textbook © 2011 by Writing Spaces. This work is licensed under the Creative Commons Attribution-Noncommercial-ShareAlike 3.0 Unported License and are subject to the Writing Spaces Terms of Use. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/3.0/or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA. To view the Writing Spaces Terms of Use, visit http://writingspaces.org/terms-of-use. All rights reserved. The Writing Spaces mission is to grow an active community of teachers that improves student learning by creating, using, and promoting open educational resources for the writing classroom. Grand Valley State University’s Sustainable Community Development Initiative is the institutional home for the Writing Spaces project.