Wiley wikipatterns dec 2007 ISBN 0470223626 pdf

Wikipatterns Stewart Mader Wiley Publishing, Inc Wikipatterns Wikipatterns Stewart Mader Wiley Publishing, Inc Wikipatterns Published by Wiley Publishing, Inc 10475 Crosspoint Boulevard Indianapolis, IN 46256 www.wiley.com Copyright  2008 by Wiley Publishing, Inc., Indianapolis, Indiana Published simultaneously in Canada ISBN: 978-0-470-22362-8 Manufactured in the United States of America 10 No part of this publication may be reproduced, stored in a retrieval system or transmitted in any form or by any means, electronic, mechanical, photocopying, recording, scanning or otherwise, except as permitted under Sections 107 or 108 of the 1976 United States Copyright Act, without either the prior written permission of the Publisher, or authorization through payment of the appropriate per-copy fee to the Copyright Clearance Center, 222 Rosewood Drive, Danvers, MA 01923, (978) 750-8400, fax (978) 646-8600 Requests to the Publisher for permission should be addressed to the Legal Department, Wiley Publishing, Inc., 10475 Crosspoint Blvd., Indianapolis, IN 46256, (317) 572-3447, fax (317) 572-4355, or online at http://www.wiley.com/go/permissions Limit of Liability/Disclaimer of Warranty: The publisher and the author make no representations or warranties with respect to the accuracy or completeness of the contents of this work and specifically disclaim all warranties, including without limitation warranties of fitness for a particular purpose No warranty may be created or extended by sales or promotional materials The advice and strategies contained herein may not be suitable for every situation This work is sold with the understanding that the publisher is not engaged in rendering legal, accounting, or other professional services If professional assistance is required, the services of a competent professional person should be sought Neither the publisher nor the author shall be liable for damages arising herefrom The fact that an organization or Website is referred to in this work as a citation and/or a potential source of further information does not mean that the author or the publisher endorses the information the organization or Website may provide or recommendations it may make Further, readers should be aware that Internet Websites listed in this work may have changed or disappeared between when this work was written and when it is read For general information on our other products and services or to obtain technical support, please contact our Customer Care Department within the U.S at (800) 762-2974, outside the U.S at (317) 572-3993 or fax (317) 572-4002 Library of Congress Cataloging-in-Publication Data is available from the publisher Trademarks: Wiley and the Wiley logo are registered trademarks of John Wiley & Sons, Inc and/or its affiliates, in the United States and other countries, and may not be used without written permission All other trademarks are the property of their respective owners Wiley Publishing, Inc., is not associated with any product or vendor mentioned in this book Wiley also publishes its books in a variety of electronic formats Some content that appears in print may not be available in electronic books To Amy It is not the strongest of the species that survives, nor the most intelligent, but those most adaptive to change Charles Darwin Appendix ■ Questions & Answers opinions in person, and are more likely to share them online, when they have more time to articulate their points, and are less pressured to immediately offer follow-up comments or rebuttal to differing opinions For instance, if someone offers an idea on the wiki, and someone else posts a comment asking for further details, clarification on a specific point, or simply offers a differing opinion, the author of the original idea can reflect on the comments and take time to craft a well thought out reply Also, use of the wiki can provide a space for discussions and collaboration to continue after a face-to-face meeting has ended, or before one has started In the former case, this allows people to keep working on an issue in a way that fits their schedules and allows each to contribute when it’s most convenient In the latter case, starting discussion and collaboration on a topic can make the in-person meeting much more productive because people will already have begun work and identified the areas that need further discussion during the meeting This results in shorter, more focused meetings, and the cycle of online and in-person collaboration takes advantage of the best of both, and makes the process more inclusive of everyone involved 153 Index Index A About Boxes, 20 access, permissions, 131–133, 144 accuracy, 26 See also grammar PDF, 145 wiki, 145 Wikipedia, 26, 27–28, 30 Word, 145 Adobe Acrobat, 136 See also PDF adoption phase All Wiki All the Time, 112–113 anti-patterns, 10, 13 wikipatterns.com, 22 BarnRaising, 96 ContentAlert, 98, 99 document business processes, 99 intentional error, 98 Invitation, 94 new employees, 98 obstacles, 107–116 patterns, 10, 13 for wikipatterns.com, 22 personal spaces, 95 pilot program to, 87–100 seed content, 97 SingleProblem, 96–97 StartingPot, 95 support system, 93 training, 93 welcoming, 95 WikiChampion, 94, 123 agendas, 22, 31, 38 meetings, 147 Red Ant, 78 Agile, 21 All Wiki All the Time, 22 adoption obstacle, 112–113 all-virtual wiki, 28–29 Amapedia, 122 Amazon, 122 anonymity, 29, 138 permissions, 132 anti-patterns, 10, 107–116 See also people anti-patterns adoption phase, 10, 13 wikipatterns.com, 22 All Wiki All the Time, 112–113 BeanCounter, 111–112 Do-it-alls, 107–108, 142 empty pages, 112 Manager Lockdown, 113–114 misunderstanding, 116 157 158 Index ■ A–C anti-patterns (continued) OverOrganizer, 108–109 Sandbox, 111 too much structure, 114–115 WikiPaintBrush, 115–116 Wikiphobia, 110 WikiTroll, 109–110 Apple, 63–64 approval chain, 42–43 ARC Centre of Excellence for Creative Industries & Innovation (CCI), 134, 137 ARPANET, Atlassian, author’s role, 71 blogging, 51 Confluence, 137 extranet, 51 JIRA, 137 transparency, 51–52 user-licenses from, 134 Automatic Index, 22, 104 Red Ant, 78 B back-office, to front-office, 54–55 BarnRaising, 22 adoption phase, 96 universities, 84 BaseCampHQ, 137 BeanCounter, 111–112 BeJUG See Belgian Java User Group Belgian Java User Group (BeJUG), 101 blogging, 21, 38 Atlassian, 51 gratification from, 150 internal, 34 John Hopkins University, 38 NMP, 134 personal spaces, 68 semiprivate, 134 universities, 81 wikis, 137 bolding, 45 Brightcove, 147 Britannica, 27–28, 151 broken links, 123 bugs, 137 bullet points, 47, 133 C c2.com/cgi/wiki?WelcomeVisitors, Calado, Jeff, 103–105 calendars plug-ins, 105 category scheme, 138 CCI See ARC Centre of Excellence for Creative Industries & Innovation CCI National Mapping Project See national mapping project Celtic Football Club, 117–119 Center for Scholarly Technology (CST), 81 centralization, project information, 105 Champion, 22, 38 Kerrydale Street, 118 change notification, 152 email, 49, 60 RSS feeds, 49, 60, 142 changes, 48–49 See also editing importance, 124–125 wiki, 152 Charman, Suw, chatting, 137 checklists See task checklists citation links, 136 CiteULike.com, 136 classification registry, 138–139 Index clients, 33 Red Ant, 78 wikis, 76 CM See content management CMS See course management system collaboration advantages, 151 email, 130, 142 JavaPolis, 102 meetings, 130 NMP, 133 phone calls, 130 Sun Microsystems, 87–88 university assignments, 85 wiki, 103, 151 Word, 142 collation, 137 communication, 22 external, 34–35 Red Ant, 78 Community Write, 22 confidentiality, 88–89 enterprise wiki, 144 Confluence, 7, 44, 51, 134 Atlassian, 137 NMP, 130, 134, 136–137 OPML, 139 permissions, 144 wiki markup, 46 Confluence Extension, 44 Constitution Day, 127–128 Invitation, 128 permissions, 128 templates, 128 WYSIWYG, 128 consumer-oriented hosted wiki service, 118 contact lists, 79 content, 93 control, from social control, 102 hierarchy, 114 intranet, 88 ■ C–D wiki, 146 content management (CM), 41–42, 132 intranet, 57–58 project management, 149 templates, 52 wiki, 44 vs wiki, 134 ContentAlert, 22, 30, 38 adoption phase, 98, 99 context-building, 152 contributors, 131 control, 145 hierarchy, 42 vs trust, 49–51 course management system (CMS), 81–84 security, 82 Cox, Sarah, 92 creative industries, 130, 134 credit card numbers, 91 criticism, 109–110 cross-linking, NMP, 133 CST See Center for Scholarly Technology Cunningham, Ward, 4–5, 43 Curry, Adam, 27 customers See clients D dashboards, 21 enterprise wiki, 45 data analysis, 76–77 databases, 43 NMP, 138 deletion, 142–143, 152 design groups as WikiFairy, 104 as WikiZenMaster, 104 DevonThink Professional, 136 Dilley, Mark, 96 disclaimers, 89 discussion boards, 81 159 160 Index ■ D–G document business processes, adoption phase, 99 document management, 37 DOIs, 136 Do-it-alls, 107–108, 142 dynamic task lists, 136–137 E editing, 25–26, 34–35, 45–48, 141–142 See also revision history email, 55–56 managers, 113–114 NMP, 133 pilot program, 68 simultaneity, 59 wiki, 56–57 Wikipedia, 144 Eiji Toyoda, 1–3 email, 3, 34 attachments, 39 change notification, 49, 60 collaboration, 130, 142 documents, 37 editing, 55–56 enterprise wiki, 45 reduction, 39 subscription, 104 wiki, 104, 137, 147–148 vs wiki, 55–57 email link, wiki as, 69 Email to Wiki, 22 Emma See Enterprise Management and Media employees See new employees empty pages, 22, 112 deletion, 115 from too much structure, 114 EndNote, 136 English, 67 Enterprise 2.0, 150 Enterprise Management and Media (Emma), 18–23 WikiChampion, 19 enterprise wiki, 44–45, 103 confidentiality, 144 dashboards, 45 email, 45 permissions, 50, 144 privacy, 144 Red Ant, 76 RSS feeds, 45 Sun Microsystems, 61 ePortfolio, 83 eResearch, 134 event planning, 33 explicit knowledge, 43 external communication, 34–35 extranet, 33–34 Atlassian, 51 F fan sites, 117 FAQ, 22, 32 Finance Team, LeapFrog, 92 financial disclosure laws, 89 financial services industry, 71 firewalls, 19 Sun Microsystems, 61 flaming, 29 Fly Fusion, 92, 93 folksonomy, 134 forums, 130–131 FOSS Open Hardware Documentation, 62 front-office, back-office to, 54–55 FTP, 130 FutureLinks, 22 G gatekeepers, intranet, 58 Google, 132 Google Video, 147 grammar, 145–146, 148 GraphXML, 139 Index grassroots, 21 Groove.net, 138 groups design groups, 104 newsgroups, 137 permissions, 131–133 H hierarchy, 48 content, 114 control, 42 flattening, 125 wiki, 44 Higdon, Jude, 81–85 Higgs, Peter, 129–139 Hillhouse, Tom, 127–128 homepage projects, 104 as table of contents, 115 How to Use this Wiki, 22 HTML, 47, 133 human intelligence, 42 Hurricane Katrina, 82 Hypergraph, 139 hyperlinks, 47, 147 I iCAL, 105 IdentityMatters, 104 ignorance, 116 IM screen names, 146 images, 147 information centralization, 105 filtering, 77 redundancy, 50–51, 91 security, 91 sensitivity, 88–89 intellectual property, 88–89 intentional error, adoption phase, 98 intranet, 33–34, 38 CM, 57–58 ■ G–K content, 88 gatekeepers, 58 John Hopkins University, 38 vs wiki, 57–58 Invitation, 22, 38, 104, 146 adoption phase, 94 Constitution Day, 128 Red Ant, 78 iPod, 63–64 ISBNs, 136 IT, 150 italics, 47 iTunes, 64 J Java, Emma, 18 JavaPolis, 101–102 collaboration, 102 JIRA, 21, 134 Atlassian, 137 Jobs, Steve, 64, 125–126 John Hopkins University, 37–39 blogging, 38 intranet, 38 meetings, 38 judgment, 89–90 K Kay, Alan, Kerrydale Street, 117–119 Champion, 118 growth, 118–119 registration, 118 WYSIWYG, 118 Kiichiro Toyoda, KM See knowledge management knowledge base, 32–33 knowledge management (KM), 41–43 failure, 122 workflow, 42 161 162 Index ■ L–N L language, 67 laptops, security, 71, 91 large-scale adoption See adoption LaTeX, 26 LDAP See Lightweight Directory Access Protocol LeapFrog, 17–23, 92 Finance Team, 92 Levy, Steven, 64 LGPL, 134 Lightweight Directory Access Protocol (LDAP), 45, 65, 90 NMP, 132, 134 link(s) broken, 123 citation, 136 email, 69 hyperlinks, 47 linkage enhancer, 137 NMP, 138 LinkedIn.com, 137 logins, 79, 132 Los Angeles Times, 122 Lunch, Red Ant, 78 Lunch Menu, 22 universities, 84 M Mac G4, 130 Magnet, 22, 38 Maintainer, 22, 38 See also PageMaintainer Calado as, 104 maintenance, Red Ant, 77 Manager Lockdown, 113–114 managers editing, 113–114 transparency, 114 market testing, 64 meetings, 31, 38 agendas, 147 collaboration, 130 John Hopkins University, 38 templates, 52–54 wiki, 147 meta data system, 136 Constitution Day, 128 Microsoft, 29 Microsoft Word See Word A Million Penguins, 122 misunderstanding, 116 Mozilla, 125 MS Project Server, 21 MySpace, 22, 38, 146 MySQL database, 101 N Naming Conventions, 22 National Constitution Center, 127–128 national mapping project (NMP), 129–139 blogging, 134 collaboration, 133 Confluence, 130, 134, 136–137 cross-linking, 133 databases, 138 editing, 133 LDAP, 132, 134 linkage enhancer, 138 objectives, 130–131 RSS feeds, 133 Nature, 27–28 Networked Info, 22 networking sandboxes, 137 NeuroScholar, 134 new employees, 105 adoption phase, 98 welcoming, 104 New Starter, 22 newsgroups, 137 newsletters, 137 NMP See national mapping project Index notification See change notification Nupedia, 26 O obstacles See anti-patterns offline work, 148 OneHammer, 22 OneWikiSpacePerGroup, 22, 83, 104 Constitution Day, 128 Red Ant, 77 OPML, Confluence, 139 Oracle, 21 Orkut.com, 137 out of office calendars, 105 OverOrganizer, 108–109 OverviewPages, 22, 83 P PageMaintainer, 88, 123, 146 pain points, 66 passwords, 79 pattern page, 14 patterns See also people patterns adoption phase, 10, 13 for wikipatterns.com, 22 PDF, 134 accuracy, 145 exporting to, 147 peers directory, 30–31 review, 26 support, 93 people anti-patterns, 10, 12 wikipatterns.com, 22 people patterns, 10, 12 wikipatterns.com, 22 Permission Granted, 22 permissions, 34, 45 access, 131–133, 144 anonymity, 132 Confluence, 144 ■ N–P Constitution Day, 128 enterprise wiki, 50, 144 groups, 131–133 turning or off, 144 users, 131–133 personal spaces, 51 adoption phase, 95 blogging, 68 pilot program, 67–68 phone calls, collaboration, 130 physical community wiki, 28–29 pilot programs to adoption, 87–100 editing, 68 house rules, 66–67 long term, 70–71 participants, 65 personal spaces, 67–68 phases, 90 purpose, 66 recruitment, 66 representation, 65 Scaffold, 68–69, 70 size, 65 templates, 68–69 time frame, 64–65 wiki, 63–72 plug-ins calendar, 105 Hypergraph, 139 software, 54 Poker, 22 privacy, 5–6 enterprise wiki, 144 privileges See permissions product development, 32 profile pages, projects, 31–32 documentation, 38 homepage, 104 information, centralization, 105 163 164 Index ■ P–S projects (continued) management with CM, 149 with wiki, 149 planning, 136–137 pseudo-anonymity, 138 public website, 35, 50 Q Queensland University of Technology (QUT), 129–139 quotation citations, 123 QUT See Queensland University of Technology R recruitment pilot programs, 66 wiki, 151 Red Ant, 75–79 agendas, 78 enterprise wiki, 76 Invitation, 78 OneWikiSpacePerGroup, 77 transparency, 76, 78–79 WikiZenMaster, 77 redundancy, 50–51, 91 registration, 62 Kerrydale Street, 118 release notes, 105 renegades, 121–122 Resin web server, 101 Rethans, Anthony, 90 revision history, 48–49, 142 rights expression language, 131 ROI, 150 RSS feeds change notification, 49, 60, 142 enterprise wiki, 45 NMP, 133 RSVPs, 33 S Sandbox, 111 Scaffold, 22, 38 Constitution Day, 128 pilot program, 68–69, 70 Red Ant, 77 universities, 83 scalability, 82 SEC See Securities and Exchange Commission Securities and Exchange Commission (SEC), 71 security, 5–6, 29–30 See also confidentiality; permissions CMS, 82 firewalls, 19, 61 information, 91 laptops, 71, 91 seed content, adoption, 97 seed spaces, 93 segment analysis, 138 Selective Rollback, 22 universities, 84 shared drive, vs wiki, 58–60 Shibboleth, 82 simultaneous editing, 59 Sinbad, 29 Single Problem, 22, 105 adoption phase, 96–97 smalltalk programming language, Snowden, Dave, 42 social control, content control from, 102 social security numbers, 91 software, 43 control, 49 features, 124 plug-ins, 54 software design patterns, Sony Ericsson Developer World Wiki, 66–67 sourceforge.net, 134 Index spaces, 19–20, 44 StartingPoint, 22, 38 adoption phase, 95 Red Ant, 78 student information system, 37–39 subscription, email, 104 Subversion, 21 Subversion source code repositories, 21 sub-wikis See spaces Sun Microsystems, 61–62 collaboration, 87–88 enterprise wiki, 61 firewalls, 61 trolling, 62 valism, 62 support site, 32–33 support system, adoption phase, 93 T table formatting, 133 table of contents, homepage as, 115 tacit knowledge, 43 tagging, 48 Taiichi Ohno, 2–3 task checklists, 77, 136–137 task management, 136–137 Taylor, Chris, 122 team management, 136–137 technology, dependence, 122 templates, 52–54 See also Scaffold CM, 52 Constitution Day, 128 meetings, 52–54 pilot programs, 68–69 Red Ant, 77 user-generated, 52–54 test space See Sandbox Test Track Pro, 21 ■ S–U ThreadMode, 22 universities, 84 TomCat, 19 Toyota Motor Corporation, 1–3 training, 22 adoption phase, 93 transparency, 121 Atlassian, 51–52 managers, 114 Red Ant, 76, 78–79 Trellis pattern, 104 trolling, 109–110 Sun Microsystems, 62 trust, 39 vs control, 49–51 typos, 123, 133 U Udell, Jon, 26 universities, 81–85 See also John Hopkins University; Queensland University of Technology assignments, collaboration in, 85 BarnRaising, 84 blogging, 81 Lunch Menu, 84 research, 134–135 Scaffold, 83 Selective Rollback, 84 ThreadMode, 84 WikiZenMaster, 84 URLs, 132, 146 use policy, wiki, 87–90 user(s) permissions, 131–133 profiles, 93 user-generated templates, 52–54 user-licenses, from Atlassian, 134 Using Wiki in Education (Mader), 35 165 166 Index ■ V–W V vandalism, 29 Sun Microsystems, 62 Viral, 22, 38 virtuous cycles, 132 W Wales, Jimmy, 26 Web 2.0 tool, 4, 54–55, 137 WebDAV, 105, 130 welcoming adoption phase, 95 new employees, 104 The Whole Earth Catalog, 126 ”Why commercial wikis don’t work” (Taylor), 122 wiki, 3–5 See also enterprise wiki accuracy, 145 all-virtual, 28–29 blogging, 137 changes, 152 chatting, 137 clients, 76 CM, 44 vs CM, 134 collaboration, 103, 151 common goals, 122–123 as comprehensive guide, 118 as conference website, 102 content, 146 contributors, 131 data analysis, 76–77 deletion, 142–143, 152 editing, 56–57 email, 104, 137, 147–148 vs email, 55–57 as email link, 69 focus, 122–123 as forum, 130–131 grassroots support, 6–7 growth, 118–119 hierarchy, 44 images, 147 vs intranet, 57–58 IT, 150 Mac G4, 130 meetings, 147 newsgroups, 137 newsletters, 137 physical community, 28–29 pilot program, 63–72 processes, 123–124 project management, 149 recruitment, 151 server, 43 vs shared drive, 58–60 software code, 43 spaces, 19–20 term use, 115 URLs, 132, 146 usability, 133 use policy, 87–90 wiki markup, 45–46 Confluence, 46 Wiki not Email, 22, 38 WikiChampion, 6, 88, 145 adoption phase, 94, 123 Calado as, 103–105 Emma, 19 as renegade, 121–122 WikiFairy, design group as, 104 WikiGardener, 84, 88, 123, 145 WikiGnome, 38, 145 Calado as, 104 Red Ant, 77 WikiPaintBrush, 22, 115–116 wikipatterns.com, 9–14, 22 author’s role, 72 public website, 35 as wiki resource, 123 Wikipedia, 5–6, 25–35, 130, 151 accuracy, 26, 27–28, 30 editing, 144 Index history, 26–27 openness, 29 Wikiphobia, 110 Wikitorial, 122 WikiTroll, 109–110 WikiWikiweb, WikiZenMaster, 22, 38, 104 design group as, 104 Red Ant, 77 universities, 84 WIP page, 77 Word, 134 accuracy, 145 collaboration, 142 exporting to, 147 work flow, KM, 42 working offline, 148 WYSIWYG, 22, 47–48 Constitution Day, 128 Kerrydale Street, 118 X XML, 29, 139 Y YouTube, 147 ■ W–Y 167 .. .Wikipatterns Stewart Mader Wiley Publishing, Inc Wikipatterns Wikipatterns Stewart Mader Wiley Publishing, Inc Wikipatterns Published by Wiley Publishing, Inc 10475... Crosspoint Boulevard Indianapolis, IN 46256 www .wiley. com Copyright  2008 by Wiley Publishing, Inc., Indianapolis, Indiana Published simultaneously in Canada ISBN: 978-0-470-22362-8 Manufactured in... Cataloging-in-Publication Data is available from the publisher Trademarks: Wiley and the Wiley logo are registered trademarks of John Wiley & Sons, Inc and/or its affiliates, in the United States and