{"id":4405,"date":"2020-05-21T10:49:43","date_gmt":"2020-05-21T10:49:43","guid":{"rendered":"https:\/\/www.dgen.net\/0\/?p=4405"},"modified":"2020-05-21T10:53:00","modified_gmt":"2020-05-21T10:53:00","slug":"design-for-search","status":"publish","type":"post","link":"https:\/\/dgen.net\/0\/2020\/05\/21\/design-for-search\/","title":{"rendered":"How Can We Stop Losing Our Minds?: Producing a Legacy From Development Projects, Not Just a Document"},"content":{"rendered":"<p>&nbsp;<\/p>\n<div class=\"excerpt\">\n<p>Have you ever run, funded or been part of a development project?<\/p>\n<p>Have you ever gotten to the end of it and felt that, during the process, everyone had learned and grown, and had stories to share?<\/p>\n<p>Have you ever thought, \u201cWe should definitely share what we learned\u201d?<\/p>\n<p>And then someone wrote a report. And that was the end of that.<\/p>\n<p>It continues to surprise me that we keep forgetting (or ignoring) the things that we all know: that building on history requires us to listen and learn from others\u2019 experiences. Instead, we like to invent our own new things \u2013 and we repeat the same mistakes ad nauseam.<\/p>\n<p>The web has changed our world in ways that we are still only beginning to learn, but development professionals haven\u2019t yet leveraged it to full effect. As a tool we\u2019ve applied it well in some cases, as more people have access to more knowledge than at any time in history. Yet we\u2019ve also applied it poorly: While information retention within our institutions may be going up, our knowledge retention often lags behind. So we see discussions on secure chat channels lead to pivotal decisions, then vanish as if the conversations had never happened.<\/p>\n<p>We still have much to do to adapt our behaviours and cultures to work with these new tools. We need to keep thinking through how we are going to make the most of both human and machine experiences, as they increasingly combine.<\/p>\n<p>These might feel like hard questions, but if we shift the way we approach solving problems together, we might come up with new answers.<\/p>\n<p>&nbsp;<\/p>\n<h2><strong>DESIGNING FOR SEARCH \u2013 AND OPEN ACCESS<\/strong><\/h2>\n<p>Let\u2019s start with a user need. Think of a project you worked on six years ago. You\u2019re trying to solve a similar issue now, but you can\u2019t remember how you did it before. You remember that there was a really good idea, a phrase, a table of data, a use-case or an interview that helped your team to find a solution. But how do you find the thing you remember?<\/p>\n<p>You might, as many people do (whether allowed or not), carry a backup of all the project details around on an old hard drive. You might try and find the old project website, if there was one (which is likely). You might try a funder\u2019s website to see if they have a copy. You might email a colleague who worked with you on the project \u2013 you might even call them.<\/p>\n<p>However you frame this, your starting point is to conduct a \u201csearch.\u201d But a search for what? The project title? The name of a person or a topic? What if you can\u2019t find it? What if the information you\u2019re looking for is in the notes from a phone call, which were never properly categorized in the first place?<\/p>\n<p>This all leads us to our first design principle:\u00a0<strong>Design for search<\/strong>.<\/p>\n<p>What does this mean? First and foremost it means something very simple: Did you add enough words to your digital files (e.g. in the title) so that when you type words into a search box six years later, you might have a chance of finding it?<\/p>\n<p>In the age of the web, this is harder than it might seem. The average website survives\u00a0<a href=\"https:\/\/www.orbitmedia.com\/blog\/website-lifespan-and-you\/\" target=\"_blank\" rel=\"noopener noreferrer\">less than three years<\/a>\u00a0so we also need to make sure this information can be searched for at all. There\u2019s a huge spectrum: Google isn\u2019t going away anytime soon (probably); your project website will atrophy rapidly (unless funded); Wikipedia may or may not quite fit; Archive.org archives pages more than their context; national libraries have lasted centuries, but may not be as interested in hosting your project files as you might wish.<\/p>\n<p>This drives us to a solution that is culturally different than what most of us are used to. Rather than publishing project details \u201cin your house\u201d (i.e. on your organization\u2019s website, which is usually designed around the hierarchy of the organization, and still reflects its physical structure), you should focus on publishing in \u201ceveryone\u2019s house\u201d (i.e. on popular websites with a digital-native structure that reflect all users\u2019 needs, not just those of your organization). You should, therefore, place your content in as many different places as possible to maximise the chance that you, your colleagues, funders, partners \u2014 and the rest of us in the development space \u2014 can find it.<\/p>\n<p>Our second design principle is:\u00a0<strong>Publish widely under an open license \u2013 or at least for open access<\/strong>. By providing context and publishing widely, under open licenses such as Creative Commons, development professionals can create a better return on our collective investment. We can help the machines help us find things. To give one example that\u2019s likely to resonate: How many of you have used Google to get a copy of your own company\u2019s logo?<\/p>\n<p>&nbsp;<\/p>\n<h2><strong>WHY, WHAT AND WHERE ARE YOU PUBLISHING \u2013 AND FOR WHOM?<\/strong><\/h2>\n<p>There\u2019s an essential question that\u2019s deeply linked to enabling others to find, use and build upon your work: Is what you are producing relevant to the people who could potentially use it?<\/p>\n<p>How often have you encountered a summary report that is written for \u201cpeople\u201d rather than for \u201cyou\u201d? On a regular basis, I find myself asking, \u201cWho is this written for \u2013 what is their name, role and organization?\u201d If you can\u2019t answer that question, then let\u2019s pause for thought.<\/p>\n<p>Some questions you should answer to define your audience include:<\/p>\n<ol>\n<li><strong>Why are we publishing this \u2014 what\u2019s the story?<\/strong><br \/>\nStart by writing down the essentials. This can involve writing the press release for every project. It\u2019s not that everything should go through PR, but the process of thinking about the story and the specific audience is critical. Who will act upon it and why? In many instances we know that there are likely only 20 people who will read any report in-depth, and maybe 100 who might read an executive summary \u2014 so it can be helpful to write the summary first. How will you describe this work to someone verbally in two years? This is a powerful, behaviour-driving question.<\/li>\n<li><strong>What are we publishing?<\/strong><br \/>\nIs it a document? A PDF? Slides? Images? Data? Code? Algorithms? What\u2019s useful to the user? Why? What format do they (not we) need most?<\/li>\n<li><strong>Where are we publishing?<\/strong><\/li>\n<\/ol>\n<p>Certainly, everyone wants to publish on their own websites, but where are your users obtaining their information? Go to where they might find you. The ambition here is, in most cases, not to drive traffic back to your website. You\u2019re not a destination, the content is. If I\u2019m going to find it, it should be in as many relevant places as possible (e.g. blogs, Instagram, LinkedIn, Slideshare, Pinterest, Wikipedia, Archive.org, Github, postcards, books and videos). This isn\u2019t about having a social media strategy to flood people with your content (you do that already). It\u2019s about making sure that when your site is dead and the team is scattered to the wind, you can all find your own work again.<\/p>\n<p>Once you have a sense of your likely readers and their needs and information sources, ask how you can:<\/p>\n<ul>\n<li>Get diverse input when evaluating users\u2019 needs<\/li>\n<li>Define a common language and use it: If you\u2019re using words with various or ambiguous meanings, make sure your intended meaning is clear and consistent<\/li>\n<li>Make outputs available in machine- and human-usable formats<\/li>\n<li>Tell stories to help people learn, including recurring storytelling to prompt recall<\/li>\n<li>Use shared documentation systems and shared tools such as wiki\u2019s, Google documents, Github and Trello \u2013 not isolationist \u201cneed to know\u201d systems<\/li>\n<li>Work with institutions of accountability to enable longevity of access (e.g. libraries, universities, national archives)<\/li>\n<\/ul>\n<p>The answers to these questions can help you deliver content that\u2019s likely to reach the people who need it, not just now but for years to come.<\/p>\n<p>&nbsp;<\/p>\n<h2><strong>CHANGING HOW WE WORK TO BE OPENLY COLLABORATIVE<\/strong><\/h2>\n<p>In my time running the\u00a0<a href=\"https:\/\/theodi.org\/\" target=\"_blank\" rel=\"noopener noreferrer\">Open Data Institute (ODI)<\/a>, we took extensive measures to foster a culture of open sharing and long-term accessibility of information. I mandated the creation of shared Google documents. The sending of attachments (internally) was banned. The guiding principles of this approach were reflected in this checklist, to be followed with all documents:<\/p>\n<ol>\n<li>Create a document.<\/li>\n<li>Name the document with keywords relevant to a later search (e.g. date, topic, themes, place, hashtag equivalents).<\/li>\n<li>Share it with everyone in the company (organization-wide).<\/li>\n<li>Reduce sharing to a named list\u00a0<em>if\u00a0<\/em><em>required\u00a0<\/em>(e.g. for HR or legal reasons).<\/li>\n<li>Start writing.<\/li>\n<\/ol>\n<p>This applied to all meetings (internal and external), as well as all operational documents, research, proposals, HR, budget, financial reporting, sales planning and reports, project plans, performance metrics, board reports, compliance reporting, and legal and accounting documents. Instead of each person writing something, then emailing a document, we would schedule short group working sessions to simultaneously edit documents, often while in voice contact to discuss anything unclear. This produced better outcomes, and was also far faster \u2014 but only after induction and training, as it takes practice to work so differently.<\/p>\n<p>Once learned, this process was also applied to co-create proposals with clients. The outcome was that the client could input directly to proposal documents, engage in internal Q&amp;As about scope and budget, and shape outputs, timing and costs. This improved the team\u2019s relationships with clients and their trust in the team.<\/p>\n<p>Induction documents and guides were provided for all staff on the process, naming conventions (e.g. <a href=\"https:\/\/xkcd.com\/1179\/\">dates written in ISO format<\/a>), how to add keywords to document titles to aid searchability, and security and privacy guidelines. Design for search was a guiding principle.<\/p>\n<p>The power of an open approach to development has many benefits. Done well, it changes the way people collaborate during projects \u2014\u00a0<strong>they are producing a legacy, not a document<\/strong>.<\/p>\n<p>As the ODI Labs team expressed,<\/p>\n<blockquote><p>\u201cAt the Open Data Institute, we build all our technology in the open. This may seem terrifying, but it\u2019s probably one of the most powerful things we do. By using open tools and practices, we communicate better as a team, engage with our community, avoid cutting corners, and at the end of the day, produce better results.\u201d<\/p><\/blockquote>\n<p>One cultural imperative is essential to this approach: bravery. It is not possible for any team to share widely, embrace openness \u2013 and be open to the potential criticism that this may cause \u2013 without total buy-in and support from leadership: from the board-down, and from the practitioners-up. Openness flattens hierarchies, and it can also lead to different emotional responses and power dynamics.<\/p>\n<p>But this only serves to illustrate, again, that the way to stop ourselves from losing our minds is to embrace our humanity, and to acknowledge that we need to work together to join the collective intelligence of humans and machines. The process may seem scary, but it may be one of the most powerful things we can do.<\/p>\n<\/div>\n<p>This article was originally published at\u00a0<a href=\"https:\/\/nextbillion.net\/producing-legacy-development-projects\/\">https:\/\/nextbillion.net\/producing-legacy-development-projects\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>&nbsp; Have you ever run, funded or been part of a development project? Have you ever gotten to the end of it and felt that, [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":4142,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[5,35,38,11],"tags":[],"class_list":["post-4405","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-business","category-culture","category-government","category-publications"],"jetpack_featured_media_url":"https:\/\/dgen.net\/0\/wp-content\/uploads\/2020\/03\/dgen-lighthouse.jpg","jetpack_shortlink":"https:\/\/wp.me\/pfJFK3-193","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/posts\/4405","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/comments?post=4405"}],"version-history":[{"count":3,"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/posts\/4405\/revisions"}],"predecessor-version":[{"id":4408,"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/posts\/4405\/revisions\/4408"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/media\/4142"}],"wp:attachment":[{"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/media?parent=4405"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/categories?post=4405"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dgen.net\/0\/wp-json\/wp\/v2\/tags?post=4405"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}