# ADR-0001 - Use Architectural Decision Records

## Date

2023-12-01

## Context

In a distributed team with many subteams, the best solution to communicate decisions is to use a format accessible by everyone in charge of development.

We use *Specification* and *Discovery* documents stored in Google Drive, but they present some downsides:

//
// It returns an error if the content was not a valid Go source file
// containing a package doc comment with a heading of the required
// form.
//
// This machinery enables the package documentation (typically
// accessible via the web at https://pkg.go.dev/) and the command
// documentation (typically printed to a terminal) to be derived from
// the same source and formatted appropriately.
func ExtractDoc(content, name string) (string, error) {

This directory is dedicated to tests that require a built TensorFlow wheel
file for testing, such as:

* Ensuring the entire API is importable
* Testing downstream projects against the wheel

Ensure you have Bazel installed and accessible from your command line.

These tests use hermetic Python. They also require a built TensorFlow wheel file
and a requirements_lock file. The requirements_lock file is generated by the

  // nodeTopology defines which nodes have access to the storage
  // for which capacity was reported. If not set, the storage is
  // not accessible from any node in the cluster. If empty, the
  // storage is accessible from all nodes. This field is
  // immutable.
  //
  // +optional
  optional k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector nodeTopology = 2;

     *
     * #### Examples of source code modifications which result in an **OOBM**
     *
     *  - Modification inside non-local (i.e. accessible outside) declaration without explicit return type specified
     *  - Modification of a package
     *  - Creation of a new declaration
     *  - Moving a declaration to another package
     *

/**
 * A {@link Configuration} which can reset its resolution state. This interface is
 * separate from {@code ConfigurationInternal} since that interface lives in
 * {@code :dependency-management} and is not accessible from {@code :core}.
 */
public interface ResettableConfiguration extends Configuration {

    /**
     * Call this factory (which presumably resolves this Configuration) and then reset the resolution state

    }

    private static List<ResettableExpectations> allResettableExpectationsOf(instance) {
        allInstanceFieldsOf(instance).findResults { field ->
            try {
                def fieldValue = field.tap { accessible = true }.get(instance)
                fieldValue instanceof ResettableExpectations ? fieldValue : null
            } catch (Exception ignored) {
                null
            }
        }
    }

        nameSpec,
        accessibleType<Configuration>()
    )


private
inline fun <reified T> accessibleType() =

        accumulator.classesToConstants.get('b') == [0, 8] as Set
        accumulator.classesToConstants.get('c') == [3, 4] as Set
    }

    def "accumulates accessible and private dependents"() {
        accumulator.addClass("d", hash, "reason",  [], ['x'], IntSets.EMPTY_SET)
        accumulator.addClass("a", hash, null, ["b"], ["c"], IntSets.EMPTY_SET)

				return
			}
			di, err := disks[i].DiskInfo(context.Background(), DiskInfoOptions{})
			if err != nil || di.Healing {
				// - Do not consume disks which are not reachable
				//   unformatted or simply not accessible for some reason.
				//
				// - Do not consume disks which are being healed
				//
				// - Future: skip busy disks
				return
			}

			mu.Lock()
			newDisks = append(newDisks, disks[i])
			mu.Unlock()