init commit

Author: Ethan Arrowood

README.md

@@ -0,0 +1,31 @@
+# package.json Research Hub
+
+## Goal
+
+A research analysis on the usage of `package.json` throughout the entire JavaScript ecosystem.
+
+## Research/Contribution Process
+
+> Contributions welcome! Reach out in the [Slack channel][slack-channel] for help!
+
+Within the `research` directory are a collection of markdown files each containing the analysis for one or more top-level `package.json` properties. The file, [package-json.md][package-json], contains a property research index.
+
+To contribute new research:
+- Make sure that an analysis has not already been conducted on the property or properties you are analyzing.
+  - Check the index in [package-json.md][package-json].
+  - Check in progress pull requests.
+    - If a PR seems stale, politely reach out to the author on the PR or within the [Slack channel][slack-channel].
+- Open a draft PR including the following details:
+  - Create a new file for your research in the `research` directory.
+    - The file title should be short and representative of the property or properties being analyzed.
+    - The file title should use [kebab-case](https://www.freecodecamp.org/news/programming-naming-conventions-explained/#what-is-kebab-case).
+  - Add the property or properties and the new file to the index in [package-json.md][package-json].
+    - Use reference links so they can be reused throughout the file reliably.
+  - The PR title should follow the format: `[research] Property: <property>` or `[research] Properties: <property-1>, <property-2>`.
+- Once your research is complete, mark the PR as "ready to review".
+
+To contribute to existing research:
+- Open a PR with the title `[research] Edit: <file-name.md>`.
+
+[package-json]: <./research/package-json.md>
+[slack-channel]: <https://openjs-foundation.slack.com/archives/C05AWQH5E4R>

research/dependencies.md

@@ -0,0 +1,10 @@
+# Dependencies
+
+Analysis of the following properties:
+- `"dependencies"`
+- `"devDependencies"`
+- `"peerDependencies"`
+
+## Analysis
+
+> TODO

research/package-json.md

@@ -0,0 +1,8 @@
+# package.json Analysis
+
+## Property Research Directory
+- [`"dependencies"`][dependencies]
+- [`"devDependencies"`][dependencies]
+- [`"peerDependencies"`][dependencies]
+
+[dependencies]: <./dependencies.md> "Dependencies"