Technology
This section of the toolkit is focused on activities that will help you with establishing, stabilizing, and evolving sustainable technology for your program. It is designed to help you structure discussions and gain consensus about next steps for sustainable technology for your OSS program. It is not a toolkit for day-to-day software development.
Definition: The core of each program supported by It Takes a Village is open-source software or systems serving cultural and scientific heritage organizations. There are parallels with proprietary software development processes, but working within the open source world brings its own challenges around community, resources, and governance that affect the software development process.
Instructions
Brand new to It Takes a Village in Practice? Check out our Getting Started Resources before jumping in!
Review the activities and goals below to select ones you want to use for sustainability planning. These activities are designed to help you move from one phase to the next and can be used in any order. You can use any or all of them. Suggested persona pathways are outlined at bottom of page, but it is not expected that programs would do all activities.
These activities are currently available for beta testing. As you use them, the ITAViP Co-Directors are eager for feedback via ITAV@lyrasis.org
Some beta testers have kindly provided samples of their work with activities. Those are available below as available.
Phase 1: Laying the Groundwork | |||
Phase 1 Objectives include: Understand Core Community Needs, Continue to Gather Data, and Communicate Progress and Process with Stakeholders | |||
1. Who Are Your Technology Stakeholders? | Goals: Identify and prioritize the community's technology stakeholders, create a high-level map of the technology stakeholder's characteristics, and identify the program's goal for high-priority stakeholder groups. | DOC | |
2. Technical Skills Inventory (Part One) | Goal: Create an inventory of what technical skills are required for technical staff, contributors, and users to develop, support, and maintain the platform. | DOC | |
3. Personas and Pathways | Goals: Learn how to bring contributors onto your project using tools called "personas" and "pathways," help your program plan and test how you'll interact with new contributors, and imagine what is really involved for new contributors to succeed. | DOC | |
4. Landscape Analysis | Goal: Understand where your program fits in the technology landscape, and use results to innovate, make decisions, identify opportunities for collaboration, and/or increase your program's usefulness or effectiveness. | DOC | |
5. Buy A Feature Game | Goals: Help users prioritize among a list of pre-defined (but not yet developed) features, and promote cooperation among end users. | DOC | |
6. Community QA Testing | Goals: Review program's current QA practices and evaluate whether they are structured in a manner that can be supported by the community, identify places for improvement, and conduct a successful round of Community QA | DOC | |
7. Documentation Friction Logging | Goal: Understand how usable your current documentation is via friction logging with documentation users. | DOC | |
Phase 2: Expanding and Integrating | |||
Phase 2 Objectives include: Engage the Community, Grow Thoughtfully, and Consider Integration over New Development | |||
8. Shadow Observations | Goals: Gain insight about users’ jobs, pains, and gains; learn about users’ day-to-day work in a real-life setting; and incorporate end-users’ experiences into program planning. | DOC | |
9. Recognition and Contributions | Goals: Understand how the program currently recognizes contributions, understand the kind of recognition that is most appreciated/motivating to each kind of contributor, and discover how the program can improve in this area. | DOC | |
10. Value Propositions for Job Descriptions | Goals: Create a value proposition for a new program position (e.g. community manager, technical lead) to help articulate significance of allocating resources to program leadership, and optionally, create a job description for a new program position. | ||
11. Building Welcoming Communities | Goals: Identify what documentation your program has that supports growing a successful community, and prioritize missing documentation and develop a plan for its development. | DOC | |
12. Not Invented Here: Assessing Integration Options | Goals: Identify functional requirements or feature requests that may be solved by integration, and identify and assess potential integration solutions to satisfy functional requirements or feature requests. | DOC | |
13. How We Retire Features | Goals: Identify elements of the platform that can be retired, develop a plan for communicating retirement plans with the community, and communicate the retirement decision to the community. | DOC | |
Suggested Pathways
You can use any of the activities in any order but we have designed some suggested pathways based on a few personas:
- Post Grant:
- Newbies:
- Major changes: