#+OPTIONS: toc:2 num:nil
* Purpose
-The Harmony skeleton is cloned as a starting point for git based project development. Harmony is designed to serve as a central working point for a team.
+The Harmony skeleton is cloned as a starting point for git based project development. Harmony was designed to serve as a central working point for a team.
* 1. Some nomenclature.
- Something **Created** came from God, Artists, or, apparently SQL interpreters. We will include developers in with Artists.;-) Created written material is **Authored**.
- Something **Made** is the result of assembling materials into a product. This is done by **Factories** and **Build Tools**.
-With created things it is a mystery as to how it happened. With made things we can typically point at a factory.
-
** Property Schema (The Semantic Path)
Directory names are properties bestowed upon their contents. The path is a descriptive sentence:
- =developer/authored/main.c= -> "The =main.c= file is **authored** by the developer."
- **Contents:** All human-written source code (C, Python, etc.).
** =developer/made/=
-- **Invariant:** Architecture-Agnostic Output.
+- **Invariant:** Architecture-specific Output.
- **Contents:** Intended to hold compiled programs and links back into authored interpreted programs. As a general rule, if the contents of a "made"
- directory is deleted, it can be regenerated.
+ directory are deleted, the contents can be remade from files already in the project, though perhaps with the use of third party tools and libraries.
** =developer/scratchpad/=
- **Invariant:** Transient Workspace.