Add "value created" list (#7)

* ADR clarity improvements.

* Documentation cleanup.

* Add "value created" document with an initial entry.

* Add links to main readme

README.md

@@ -8,6 +8,11 @@ The project dependencies within the workspace are:
 
 ![workspace project dependencies](./workspace-dependencies.svg)
 
+Additional documentation:
+
+- [Architectural Decision Records (ADRs)](./documents/adr/)
+- [Non-project contributions](./documents/value-created-log.md)
+
 ## Development
 
 This project uses [pnpm workspaces](https://pnpm.io/workspaces). To work with this project, [install pnpm](https://pnpm.io/installation) and then the project dependencies:

documents/adr/0005-build-system.md

@@ -16,8 +16,8 @@ A method of structuring cohesive and well-encapsulated modules is required. Addi
 
 A [pnpm](https://pnpm.io/) workspace will be utilized. Workspaces are a standard method of organizing multiple interdependent [node.js](https://nodejs.org/) packages in a single repository. pnpm offers efficient package management and well-implemented workspaces.
 
-[Turborepo](https://turbo.build/) will be leveraged to managed efficient builds. In a multi-project workspace, tracking interdependencies between packages is required. Turborepo implements an efficient caching system and executing engine that leads to efficient and developer-friend builds.
+[Turborepo](https://turbo.build/) will be leveraged to managed efficient builds. In a multi-project workspace, tracking interdependencies between packages is required. Turborepo implements an efficient caching system and execution engine that leads to efficient and developer-friend builds.
 
 ## Consequences
 
-Reasoning about dependencies will be enhanced with explicit packages per module. Additionally, dependencies will be modularized with in a manner that makes it easy to lift and shift the code to another location with a pnpm workspace. Lastly, developer efficiency will be enhanced by the fast builds provided by Turborepo.
+Reasoning about dependencies will be enhanced due to each module having an explicit package. Additionally, dependencies will be modularized in a manner that makes it easy to lift and shift the code to another location. Lastly, developer efficiency will be enhanced by the fast builds provided by Turborepo.

documents/adr/0007-initial-css-strategy.md

@@ -16,7 +16,7 @@ The project team desires a method of managing CSS using a method that maximizes
 
 The project team will theme USWDS via an encapsulated build (`@atj/design`). Any USWDS-related configuration or initialization will reside in this package.
 
-Where necessary, the Spotlight frontend application will use straight CSS.
+The Spotlight frontend will leverage this package via CSS imports. Where necessary, the Spotlight frontend application will use straight CSS.
 
 ## Consequences
 

documents/value-created-log.md

@@ -0,0 +1,5 @@
+# Value created
+
+The project team aims to stack the value it creates throughout the development of this project by improving the federal forms landscape wherever possible. This document lists notable contributions made by the project team to other efforts.
+
+- [uswds-compile PR#76](https://github.com/uswds/uswds-compile/pull/76) updates [uswds-compile](https://github.com/uswds/uswds-compile) to be compatible with alternate package managers, such as [pnpm](https://pnpm.io/).

packages/dependency-graph/src/graph-dependencies.ts

@@ -19,5 +19,5 @@ export const writeDependencyGraph = (
   dependencyGraphOutputPath: string
 ) => {
   const graph = createGraphvizDigraph(workspaceDependencies);
-  graph.output('svg', dependencyGraphOutputPath);
+  graph.output({ type: 'svg', use: 'dot' }, dependencyGraphOutputPath);
 };

packages/design/README.md

@@ -0,0 +1,3 @@
+# @atj/design
+
+This package encapsulates all the CSS styles used in 10x Digital Access to Justice frontend applications. See [documents/adr/0007-initial-css-strategy](../../documents/adr/0007-initial-css-strategy.md).