From 0a1674e1eb1cf2bde6d6ba6433a4b1f9edff13aa Mon Sep 17 00:00:00 2001 From: Cedric Hurst Date: Sun, 19 Nov 2023 21:36:18 -0600 Subject: [PATCH] docs: update structure and content --- docs/examples/index.md | 91 +++++++++++++++++++++++++++++---- docs/hypotheses-briefs/index.md | 42 ++++++++++++--- docusaurus.config.ts | 34 +++++------- 3 files changed, 129 insertions(+), 38 deletions(-) diff --git a/docs/examples/index.md b/docs/examples/index.md index ee44cf3..fdd1bd8 100644 --- a/docs/examples/index.md +++ b/docs/examples/index.md @@ -1,28 +1,97 @@ --- -title: Introduction +title: Examples sidebar_position: 1 --- -The examples provided here serve to illustrate how organizations across different sectors and business models can benefit from employing Hypotheses Briefs as a foundational tool for innovation and market assessment. Whether it's a B2C product company or a service-oriented firm, the process of crafting, testing, and validating business hypotheses remains a crucial exercise for grounded and strategic development. +The examples provided here serve to illustrate how organizations across +different sectors and business models can benefit from employing Hypotheses +Briefs as a foundational tool for innovation and market assessment. Whether it's +a B2C product company or a service-oriented firm, the process of crafting, +testing, and validating business hypotheses remains a crucial exercise for +grounded and strategic development. -[AirShare](airshare/introduction), an Airbnb-like company, operates in the consumer space, aiming to disrupt traditional lodging options by connecting homeowners with travelers seeking unique and localized experiences. This direct-to-consumer approach requires a deep understanding of user behavior, preferences, and expectations, making the hypotheses briefs exercise particularly vital in identifying and responding to market needs. For AirShare, exploring hypotheses around user engagement, platform functionalities, and market scalability helps to proactively shape their service with customer-centricity at its core. +[AirShare](examples/airshare), an Airbnb-like company, operates in the consumer space, +aiming to disrupt traditional lodging options by connecting homeowners with +travelers seeking unique and localized experiences. This direct-to-consumer +approach requires a deep understanding of user behavior, preferences, and +expectations, making the hypotheses briefs exercise particularly vital in +identifying and responding to market needs. For AirShare, exploring hypotheses +around user engagement, platform functionalities, and market scalability helps +to proactively shape their service with customer-centricity at its core. -On the other hand, [Foosoft's](foosoft/introduction) is a professional service company. Its expertise lies in providing bespoke software solutions to clients, navigating the complexities inherent to service delivery, and ensuring customer satisfaction. Here, Hypotheses Briefs are instrumental in defining value propositions, determining service capabilities, and aligning project outcomes with client objectives. Foosoft employs these briefs to validate their approaches to system architecture, data engineering, and client collaboration models—building a reputation for delivering impactful and technologically advanced solutions. +On the other hand, [Foosoft's](examples/foosoft) is a professional service company. Its +expertise lies in providing bespoke software solutions to clients, navigating +the complexities inherent to service delivery, and ensuring customer +satisfaction. Here, Hypotheses Briefs are instrumental in defining value +propositions, determining service capabilities, and aligning project outcomes +with client objectives. Foosoft employs these briefs to validate their +approaches to system architecture, data engineering, and client collaboration +models—building a reputation for delivering impactful and technologically +advanced solutions. -Both AirShare and Foosoft, despite their distinct market orientations, utilize Hypotheses Briefs to navigate uncertainty, prioritize resource allocation, and establish clear pathways for growth. These examples showcase the versatility of the hypotheses validation process and underscore its relevance not only as a practice for startups but for any business embarking on new ventures or innovations. +Both AirShare and Foosoft, despite their distinct market orientations, utilize +Hypotheses Briefs to navigate uncertainty, prioritize resource allocation, and +establish clear pathways for growth. These examples showcase the versatility of +the hypotheses validation process and underscore its relevance not only as a +practice for startups but for any business embarking on new ventures or +innovations. ## AirShare -AirShare is an ambitious startup, embarking on a journey to shake up the traditional hospitality industry with an airbnb-like service, enabling homeowners to rent out their spaces to travelers. From the very beginning, AirShare's hypotheses briefs have been centered around validating the demand for a peer-to-peer lodging platform - a place where guests can find unique accommodations and hosts can monetize their unused spaces. To test its assumptions, AirShare has been engaging with potential users through surveys and initial beta testing, aiming to refine its understanding of what both hosts and guests are seeking in such a service. +AirShare is an ambitious startup, embarking on a journey to shake up the +traditional hospitality industry with an airbnb-like service, enabling +homeowners to rent out their spaces to travelers. From the very beginning, +AirShare's hypotheses briefs have been centered around validating the demand for +a peer-to-peer lodging platform - a place where guests can find unique +accommodations and hosts can monetize their unused spaces. To test its +assumptions, AirShare has been engaging with potential users through surveys and +initial beta testing, aiming to refine its understanding of what both hosts and +guests are seeking in such a service. -As these briefs get iterated upon, AirShare is looking to confirm key factors such as the desired level of host-guest interaction, the types of properties in demand, and the necessary features to ensure safety and reliability. AirShare envisages a process of rapid prototyping followed by feedback cycles that will inform the final service design. Strategies are being hypothesized for balancing growth with community building — incentivizing early adopters through competitive pricing while nurturing a culture of trust through robust review systems. +As these briefs get iterated upon, AirShare is looking to confirm key factors +such as the desired level of host-guest interaction, the types of properties in +demand, and the necessary features to ensure safety and reliability. AirShare +envisages a process of rapid prototyping followed by feedback cycles that will +inform the final service design. Strategies are being hypothesized for balancing +growth with community building — incentivizing early adopters through +competitive pricing while nurturing a culture of trust through robust review +systems. -As AirShare develops its platform, it will closely monitor which hypotheses stand firm and which need re-evaluation. The team plans to validate the market fit through a series of MVP (Minimum Viable Product) releases, each designed to provide new insights into user behavior and preferences. By carefully testing each iteration, they aim to pinpoint the exact blend of features and services that resonate with their user base, ensuring AirShare's service is not just visionary, but truly aligned with the needs of the market. +As AirShare develops its platform, it will closely monitor which hypotheses +stand firm and which need re-evaluation. The team plans to validate the market +fit through a series of MVP (Minimum Viable Product) releases, each designed to +provide new insights into user behavior and preferences. By carefully testing +each iteration, they aim to pinpoint the exact blend of features and services +that resonate with their user base, ensuring AirShare's service is not just +visionary, but truly aligned with the needs of the market. ## Foosoft -Founded in early 2007, Foosoft stands at the forefront of custom software development and systems engineering. Headquartered in Chicago, the company's mission has been to deliver impactful software solutions to its clients. As Foosoft prepares its hypotheses briefs, the focus is on identifying and validating the most crucial business problems that its services can address. Through collaborative workshops and stakeholder interviews, Foosoft is determining the technical and business challenges prospective clients face and how best the company's services can tackle these issues. +Founded in early 2007, Foosoft stands at the forefront of custom software +development and systems engineering. Headquartered in Chicago, the company's +mission has been to deliver impactful software solutions to its clients. As +Foosoft prepares its hypotheses briefs, the focus is on identifying and +validating the most crucial business problems that its services can address. +Through collaborative workshops and stakeholder interviews, Foosoft is +determining the technical and business challenges prospective clients face and +how best the company's services can tackle these issues. -Foosoft plans to validate its service hypotheses by engaging in pilot projects, leveraging the feedback from these initial engagements to continually adapt and refine its service offerings. They are employing methodologies that were prevalent and trusted at the time, like Scrum for agile development and Vagrant for creating replicable development environments, simulating the benefits of containerization that would become popularized through platforms like Docker in later years. Foosoft is also closely observing emerging trends in the industry to iteratively introduce new technologies into its practices, ensuring that the company remains at the cutting edge. +Foosoft plans to validate its service hypotheses by engaging in pilot projects, +leveraging the feedback from these initial engagements to continually adapt and +refine its service offerings. They are employing methodologies that were +prevalent and trusted at the time, like Scrum for agile development and Vagrant +for creating replicable development environments, simulating the benefits of +containerization that would become popularized through platforms like Docker in +later years. Foosoft is also closely observing emerging trends in the industry +to iteratively introduce new technologies into its practices, ensuring that the +company remains at the cutting edge. -In preparing its service and business models, Foosoft is hypothesizing not only the technical execution but also the client's journey – from onboarding to ongoing support. The company is crafting tailored engagement models that align with client expectations and project demands. By conducting structured feedback sessions post-delivery, Foosoft ensures a loop of continuous improvement — making data-driven decisions to inform future service developments and client engagements. The firm understands the power of validation; therefore, each project milestone serves as a checkpoint for testing their initial assumptions, shaping Foosoft's trajectory as a leading software consultancy. +In preparing its service and business models, Foosoft is hypothesizing not only +the technical execution but also the client's journey – from onboarding to +ongoing support. The company is crafting tailored engagement models that align +with client expectations and project demands. By conducting structured feedback +sessions post-delivery, Foosoft ensures a loop of continuous improvement — +making data-driven decisions to inform future service developments and client +engagements. The firm understands the power of validation; therefore, each +project milestone serves as a checkpoint for testing their initial assumptions, +shaping Foosoft's trajectory as a leading software consultancy. diff --git a/docs/hypotheses-briefs/index.md b/docs/hypotheses-briefs/index.md index 072e931..073b2fe 100644 --- a/docs/hypotheses-briefs/index.md +++ b/docs/hypotheses-briefs/index.md @@ -1,25 +1,53 @@ # Hypotheses Briefs -Welcome to [Spantree's](https://spantree.net) guide to Hypotheses Briefs. Drawing from Steve Blank's pivotal [The Four Steps to the Epiphany](http://www.amazon.com/Four-Steps-Epiphany-Successful-Strategies/dp/0976470705), Hypotheses Briefs serve as the first brushstrokes on a canvas – vital for envisioning the full picture before delving into the details of company or product development. They resonate with our core value of "solving hard problems scientifically." By approaching business challenges with the rigor of the scientific method, this guide aims to equip teams with the ability to make substantiated, data-driven decisions. +Welcome to [Spantree's](https://spantree.net) guide to Hypotheses Briefs. +Drawing from Steve Blank's pivotal [The Four Steps to the +Epiphany](http://www.amazon.com/Four-Steps-Epiphany-Successful-Strategies/dp/0976470705), +Hypotheses Briefs serve as the first brushstrokes on a canvas – vital for +envisioning the full picture before delving into the details of company or +product development. They resonate with our core value of "solving hard problems +scientifically." By approaching business challenges with the rigor of the +scientific method, this guide aims to equip teams with the ability to make +substantiated, data-driven decisions. ## Embracing the Scientific Approach in Business -At Spantree, we believe that the scientific method isn't just for labs; it's a powerful framework for all sorts of innovation. Whether developing new products, providing services, or optimizing operations, crafting Hypotheses Briefs allows teams to propose, test, and refine ideas systematically. Validation through real-world feedback is not just a step; it's the path to genuine insights. +At Spantree, we believe that the scientific method isn't just for labs; it's a +powerful framework for all sorts of innovation. Whether developing new products, +providing services, or optimizing operations, crafting Hypotheses Briefs allows +teams to propose, test, and refine ideas systematically. Validation through +real-world feedback is not just a step; it's the path to genuine insights. ## Criteria for Crafting Hypotheses Briefs -Hypotheses Briefs start with a hypothesis, much like a scientific experiment. What does your organization believe is true about the product or service? These briefs channel that hypothesis through a process of testing and learning which features click, which benefits resonate, and what unique value propositions can separate you from the crowd. +Hypotheses Briefs start with a hypothesis, much like a scientific experiment. +What does your organization believe is true about the product or service? These +briefs channel that hypothesis through a process of testing and learning which +features click, which benefits resonate, and what unique value propositions can +separate you from the crowd. ## The Art and Science of Pricing and Delivery -The briefs probe deeper than just product-market fit; they also consider how a product or service is delivered and priced. Understanding the cost not only in monetary terms but also in terms of customer effort and adaptation is vital. This ensures that solutions are accessible, desirable, and viable. +The briefs probe deeper than just product-market fit; they also consider how a +product or service is delivered and priced. Understanding the cost not only in +monetary terms but also in terms of customer effort and adaptation is vital. +This ensures that solutions are accessible, desirable, and viable. ## Market and Competitive Landcape -Moreover, these briefs encourage a forward-thinking analysis of market dynamics and an acute awareness of market you're entering. Assessing how a novel offering stacks up against direct or indirect competitors also teaches the fine skill of predictive adjustments based on market responses. +Moreover, these briefs encourage a forward-thinking analysis of market dynamics +and an acute awareness of market you're entering. Assessing how a novel offering +stacks up against direct or indirect competitors also teaches the fine skill of +predictive adjustments based on market responses. ## The Spantree Way – Solving for Everyone -As a guiding principle, Hypotheses Briefs are accessible for all types of businesses – be it a company seeking to create the [next home-sharing revolution](examples/airbnb/introduction.md) or a services firm aiming to [craft bespoke software](examples/foosoft/introduction.md) that propels other businesses forward. +As a guiding principle, Hypotheses Briefs are accessible for all types of +businesses – be it a company seeking to create the [next home-sharing +revolution](examples/airshare) or a services firm aiming to [craft +bespoke software](examples/foosoft) that propels other +businesses forward. -In a spirit of knowledge sharing, this guide intends to be a trove of strategies and actionable steps for any organization to apply, broadening the impact of the scientific approach to solving hard problems across the business landscape. +In a spirit of knowledge sharing, this guide intends to be a trove of strategies +and actionable steps for any organization to apply, broadening the impact of the +scientific approach to solving hard problems across the business landscape. diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 4eb992d..b0f3f70 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -71,15 +71,9 @@ module.exports = { }, { type: 'doc', - docId: 'examples/airshare/index', + docId: 'examples/index', position: 'left', - label: 'Airbnb Example', - }, - { - type: 'doc', - docId: 'examples/foosoft/index', - position: 'left', - label: 'Foosoft Example', + label: 'Examples', }, { href: 'https://github.com/spantree/hypotheses-briefs', @@ -92,32 +86,32 @@ module.exports = { style: 'dark', links: [ // { - // title: "Community", + // title: 'Community', // items: [ // { - // label: "Github", - // href: "https://github.com/Spantree", + // label: 'Github', + // href: 'https://github.com/Spantree', // }, // { - // label: "Twitter", - // href: "https://twitter.com/spantreellc", + // label: 'Twitter', + // href: 'https://twitter.com/spantreellc', // }, // ], // }, // { - // title: "Resources", + // title: 'Resources', // items: [ // { - // label: "The Four Steps to the Ephiphany", - // href: "https://www.amazon.com/Four-Steps-Epiphany-Steve-Blank/dp/0989200507", + // label: 'The Four Steps to the Ephiphany', + // href: 'https://www.amazon.com/Four-Steps-Epiphany-Steve-Blank/dp/0989200507', // }, // { - // label: "Steve Blank", - // href: "https://steveblank.com/", + // label: 'Steve Blank', + // href: 'https://steveblank.com/', // }, // { - // label: "Google Design Sprints", - // href: "http://www.gv.com/sprint/", + // label: 'Google Design Sprints', + // href: 'http://www.gv.com/sprint/', // }, // ], // },