diff --git a/docs/The-Menagerie.md b/docs/The-Menagerie.md index c8093bb9e..0f9d34b66 100644 --- a/docs/The-Menagerie.md +++ b/docs/The-Menagerie.md @@ -30,11 +30,3 @@ The book aims to develop a _Pattern Language_ for understanding software risk, a ## Read It Here "The Menagerie" contains all of the [Overview](overview/Start.md), [Thinking Risk-First](thinking/Start.md) and [Risks](thinking/Start.md) tracks from the Risk-First website, so you can read all the material on-line here if you want to. - - -## What's Next? - -Look forward to **Risk-First Software Development Volume 2: Tools & Practices** in 2021... - - - \ No newline at end of file diff --git a/docs/practices/Glossary-Of-Practices.md b/docs/practices/Glossary-Of-Practices.md index 79d3113f0..bc472e9a2 100644 --- a/docs/practices/Glossary-Of-Practices.md +++ b/docs/practices/Glossary-Of-Practices.md @@ -13,7 +13,7 @@ sidebar_position: 1 # Glossary -### Abstraction (Using) +### Abstraction (Using) > "An abstraction" is the outcome of this process—a concept that acts as a common noun for all subordinate concepts and connects any related concepts as a group, field, or category.[1] @@ -109,7 +109,7 @@ See: - [Waterfall (One Size Fits No One)](thinking/One-Size-Fits-No-One.md) -### Environmental Scanning +### Environmental Scanning Understanding the operational environment of a system in order to anticipate future problems. @@ -118,7 +118,7 @@ See: - [Environmental Scanning](../risks/Operational-Risk.md#scanning-the-operational-context) -### Market Segmentation +### Market Segmentation A process by which you divide the addressable market of users for a piece of software into different types or _personas_ in order that you can tackle the requirements of a single group in isolation. @@ -168,7 +168,7 @@ See: - [Reliability Risk](../risks/Dependency-Risk.md#reliability-risk) -### Graceful Degredation +### Graceful Degredation Handing lack of a scarce resource by failing in a tolerable way. @@ -185,13 +185,13 @@ See: - [Scarcity Risk](../risks/Scarcity-Risk.md#mitigations) -## Product Development +### Product Development Mitigating [Feature Risk](../risks/Feature-Risk.md) by adding code to a project. Can often be called _coding_ or _implementation_. _See: [Development Process](../thinking/Development-Process.md#example_a_toy_process)_ -## Integration +### Integration Combining different versions of a codebase together to check for consistency. Also called [Continuous Integration](https://en.wikipedia.org/wiki/Continuous_integration). @@ -199,7 +199,7 @@ See: - [Development Process](../thinking/Development-Process.md#example_a_toy_process)_ - [Production (Cadence)](../thinking/Cadence.md#production) -## User Acceptance Testing (UAT) +### User Acceptance Testing (UAT) Completing a [Feedback Loop](../thinking/Cadence.md) in order to ascertain whether [Feature Risk](../risks/Feature-Risk.md) has been correctly addressed by new features. Also called _verification_, _user feedback_ or _manual testing_. @@ -209,7 +209,7 @@ See: - [Manual Testing](../thinking/Cadence.md#development-cycle-time) - [Waterfall (One Size Fits No One)](thinking/One-Size-Fits-No-One.md) -## Release +### Release The act of moving in-development software to being in production, so that clients can make use of it. @@ -218,14 +218,14 @@ See: - [Consider Payoff](../thinking/Consider-Payoff.md#example-continue-testing-or-release) - [Production (Cadence)](../thinking/Cadence.md#production) -## Testing +### Testing See: - [Unit testing](#unit-testing) - [User Acceptance Testing (UAT)](#user-acceptance-testing-uat) -## Security Testing +### Security Testing Performing tests to evaluate the security of a given system. May include _penetration testing_, for example. @@ -233,7 +233,7 @@ See: - [Penetration Testing](../risks/Operational-Risk.md#scanning-the-operational-context) -## Experimentation +### Experimentation Improving your internal model by testing (or playing with) components of the real world context. For example, building a _spike solution_. @@ -241,7 +241,7 @@ See: - [Spike Solution (Coding Bets)](../bets/Coding-Bets.md#spike-solutions-a-new-technology-bet) -## Unit Testing +### Unit Testing Writing extra (test) code in the project which can automatically check that the (main, business logic) code works correctly. Used to mitigate [Regression Risk](../risks/Feature-Risk.md#regression-risk) and [Implementation Risk](../risks/Feature-Risk.md#implementation-risk) in a short-cycle feedback loop. @@ -249,7 +249,7 @@ See: - [Development Process](../thinking/Development-Process.md#example_a_toy_process) - [Unit Testing (Meeting Reality)](../thinking/Meeting-Reality.md#example-unit-testing) -## Operation / Maintenance +### Operation / Maintenance Maintaining running software in production so that it is available for clients to use. @@ -257,7 +257,7 @@ See: - [Operational Risk](../risks/Operational-Risk.md) - [Waterfall (One Size Fits No One)](thinking/One-Size-Fits-No-One.md) -## Sign-Off +### Sign-Off The act of introducing a human-controlled approval step into a [Process](../risks/Process-Risk.md) in order to mitigate [Operational Risks](../risks/Operational-Risk.md). diff --git a/docusaurus.config.js b/docusaurus.config.js index 42c3ef22a..7689ff01d 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -53,6 +53,10 @@ const config = { theme: { customCss: './src/css/custom.css', }, + gtag: { + trackingID: '_Ah_sAWlHVd7-glADdzxCZLqt-HDlhCXLlMqlQGqLE4', + anonymizeIP: true, + }, }), ], ], @@ -62,19 +66,25 @@ const config = { ({ // Replace with your project's social card image: 'img/docusaurus-social-card.jpg', + metadata: [ + + ], navbar: { title: 'Risk First', logo: { alt: 'Risk First Logo', - src: 'img/R1_logo_round_black_small.svg', + src: 'img/R1_logo_round_white.svg', }, items: [ { to: '/overview/Start', label: 'Overview', position: 'left' }, { to: '/thinking/Start', label: 'Thinking', position: 'left' }, + { to: '/The-Menagerie', label: 'Book', position: 'left' }, { to: '/risks/Start', label: 'Risks', position: 'left' }, { to: '/bets/Start', label: 'Bets', position: 'left' }, { to: '/estimating/Start', label: 'Estimating', position: 'left' }, { to: '/complexity/Start', label: 'Complexity', position: 'left' }, + { to: '/presentations/Start', label: 'Presentations', position: 'left' }, + { to: '/misc/Start', label: 'Misc', position: 'left' }, { href: 'https://github.com/risk-first/website', label: 'GitHub', @@ -84,6 +94,11 @@ const config = { }, footer: { style: 'dark', + logo: { + alt: 'Meta Open Source Logo', + src: 'img/R1_logo_round_black.svg', + width: '100px', + }, links: [ { title: 'Docs', diff --git a/src/css/custom.css b/src/css/custom.css index 8c63b2704..cf8b91946 100644 --- a/src/css/custom.css +++ b/src/css/custom.css @@ -76,7 +76,6 @@ } } - .credits { opacity: 0.5; } diff --git a/src/theme/SiteMetadata/index.js b/src/theme/SiteMetadata/index.js new file mode 100644 index 000000000..b2bb863a9 --- /dev/null +++ b/src/theme/SiteMetadata/index.js @@ -0,0 +1,20 @@ +import React from 'react'; +import SiteMetadata from '@theme-original/SiteMetadata'; +import Head from '@docusaurus/Head'; +import { useLocation } from '@docusaurus/router'; + + +export default function SiteMetadataWrapper(props) { + + const image = '/img/generated/single'+ useLocation().pathname + ".png" + return ( + <> + + + + + + + + ); +} diff --git a/static/img/R1_logo_round_black.svg b/static/img/R1_logo_round_black.svg index 1fc9d6bce..3786eb5ef 100644 --- a/static/img/R1_logo_round_black.svg +++ b/static/img/R1_logo_round_black.svg @@ -5,7 +5,6 @@ - .st0{fill:#FFFFFF;} - + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/static/img/R1_logo_white.svg b/static/img/R1_logo_white.svg new file mode 100644 index 000000000..3314ea070 --- /dev/null +++ b/static/img/R1_logo_white.svg @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/yarn.lock b/yarn.lock index 02de6922e..c2ebe8ab9 100644 --- a/yarn.lock +++ b/yarn.lock @@ -1429,7 +1429,7 @@ "@docusaurus/utils-validation" "3.1.1" tslib "^2.6.0" -"@docusaurus/plugin-google-gtag@3.1.1": +"@docusaurus/plugin-google-gtag@3.1.1", "@docusaurus/plugin-google-gtag@^3.1.1": version "3.1.1" resolved "https://registry.yarnpkg.com/@docusaurus/plugin-google-gtag/-/plugin-google-gtag-3.1.1.tgz#7e8b5aa6847a12461c104a65a335f4a45dae2f28" integrity sha512-0mMPiBBlQ5LFHTtjxuvt/6yzh8v7OxLi3CbeEsxXZpUzcKO/GC7UA1VOWUoBeQzQL508J12HTAlR3IBU9OofSw==