From: Thomas Walker Lynch Date: Sun, 8 Mar 2026 15:00:32 +0000 (+0000) Subject: git doesn't follow symbolic link to document/LICENSE, so copying it up X-Git-Url: https://git.reasoningtechnology.com/%5B%5E?a=commitdiff_plain;h=e3bbbf36773daa5c8a1aa5c62e082dbfa6f007a2;p=Harmony git doesn't follow symbolic link to document/LICENSE, so copying it up --- diff --git a/LICENSE b/LICENSE deleted file mode 120000 index 6ba91d5..0000000 --- a/LICENSE +++ /dev/null @@ -1 +0,0 @@ -document/LICENSE \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..51c52bc --- /dev/null +++ b/LICENSE @@ -0,0 +1,7 @@ +Copyright © 2019, 2024, 2025, 2026 Reasoning Technology. All Rights Reserved. + +This software, including all source code, compiled code, text, images, graphics, and associated media (collectively, "the Software and Content"), is the proprietary property of Reasoning Technology. + +A limited license, revocable at any time, is granted to access and view the Software and Content strictly for normal web browsing purposes. + +Beyond this limited viewing permission, no other rights are granted. A person is strictly prohibited from copying, extracting, modifying, republishing, distributing, sublicensing, selling, or otherwise exploiting this Software and Content, in whole or in part, for any purpose, without express written consent from Reasoning Technology. No license to any underlying technology, patents, trademarks, or other intellectual property is granted or implied by this access. diff --git a/README.md b/README.md deleted file mode 120000 index d1aeb59..0000000 --- a/README.md +++ /dev/null @@ -1 +0,0 @@ -document/README.md \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..dc02733 --- /dev/null +++ b/README.md @@ -0,0 +1,28 @@ +# Harmony + +Harmony provides a language-agnostic project directory structure and maintenance tools for long-lived software development. It enforces clarity about where things live, utilizing role-based work areas and the strict separation of skeleton, team member authored, machine-made, and third-party software. + +While designed to manage the complexity of multi-person teams, Harmony serves equally well for an individual developer. A single person can easily assume the roles of administrator, developer, and tester simultaneously by opening separate emacs buffers or terminal windows for each role. + +## Bootstrapping a New Project + +**Important:** Do not begin writing code directly in a fresh clone of this skeleton. You must decouple your new project from the Harmony version control history to prevent accidentally committing your project files back to the upstream skeleton. + +To create a Harmony-based project, the project administrator performs these steps: + +1. Clone the Harmony project to a local directory. +2. Remove the `.git` tree. +3. Rename the Harmony directory to the name of the new project. +4. Rename the `0pus_Harmony` file to reflect the name of the new project. +5. Add a line to the `shared/tool/version` file for the new project. +6. Run `git init -b core_developer_branch` to start your own repository. + +## Viewing the Documentation + +To view the project documentation with its intended formatting, a person must provide the RT style library. It is recommended to clone the styling repository side-by-side with your new project directory, and then link it into the third-party directory. + +From the root of your new project repository, run: + +```bash +cd shared/third_party +ln -s ../../../RT-style-JS_public RT-style-JS_public diff --git a/document/LICENSE b/document/LICENSE deleted file mode 100644 index 51c52bc..0000000 --- a/document/LICENSE +++ /dev/null @@ -1,7 +0,0 @@ -Copyright © 2019, 2024, 2025, 2026 Reasoning Technology. All Rights Reserved. - -This software, including all source code, compiled code, text, images, graphics, and associated media (collectively, "the Software and Content"), is the proprietary property of Reasoning Technology. - -A limited license, revocable at any time, is granted to access and view the Software and Content strictly for normal web browsing purposes. - -Beyond this limited viewing permission, no other rights are granted. A person is strictly prohibited from copying, extracting, modifying, republishing, distributing, sublicensing, selling, or otherwise exploiting this Software and Content, in whole or in part, for any purpose, without express written consent from Reasoning Technology. No license to any underlying technology, patents, trademarks, or other intellectual property is granted or implied by this access. diff --git a/document/README.md b/document/README.md deleted file mode 100644 index dc02733..0000000 --- a/document/README.md +++ /dev/null @@ -1,28 +0,0 @@ -# Harmony - -Harmony provides a language-agnostic project directory structure and maintenance tools for long-lived software development. It enforces clarity about where things live, utilizing role-based work areas and the strict separation of skeleton, team member authored, machine-made, and third-party software. - -While designed to manage the complexity of multi-person teams, Harmony serves equally well for an individual developer. A single person can easily assume the roles of administrator, developer, and tester simultaneously by opening separate emacs buffers or terminal windows for each role. - -## Bootstrapping a New Project - -**Important:** Do not begin writing code directly in a fresh clone of this skeleton. You must decouple your new project from the Harmony version control history to prevent accidentally committing your project files back to the upstream skeleton. - -To create a Harmony-based project, the project administrator performs these steps: - -1. Clone the Harmony project to a local directory. -2. Remove the `.git` tree. -3. Rename the Harmony directory to the name of the new project. -4. Rename the `0pus_Harmony` file to reflect the name of the new project. -5. Add a line to the `shared/tool/version` file for the new project. -6. Run `git init -b core_developer_branch` to start your own repository. - -## Viewing the Documentation - -To view the project documentation with its intended formatting, a person must provide the RT style library. It is recommended to clone the styling repository side-by-side with your new project directory, and then link it into the third-party directory. - -From the root of your new project repository, run: - -```bash -cd shared/third_party -ln -s ../../../RT-style-JS_public RT-style-JS_public