Iterate on contributing document

jasonkarns · jasonkarns · commit 715d80bcea67 · 2026-04-27T20:13:09.000-04:00
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
@@ -1,15 +1,24 @@
 <!--
+This is a default contributing guide that applies to the entire testdouble organization.
+It may be overridden by a repo-specific contributing guide.
+https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file
+-->
+
+# Contributing
 
-placeholder scaffolding for a base CONTRIBUTING file.
+<!--
+TODO:
+
+fill out some generic contributing guidelines.
 The contents of this file should be fairly generic as they will apply (by default) to all testdouble repos that don't have their own CONTRIBUTING file.
 
 Probably some generic verbiage around accepting PRs;
 whether we have an AI policy;
 preference for tests and desire for simplicity, proof of value (does the value provided outweigh any additional complexity, etc)
 
-
 It is useful for this document to serve two audiences:
 1) external contributors (who may or may not be first time contributors)
 2) but also as "internal" documentation for the maintainers (ie how to trigger/publish releases, etc)
 
+I would propose that we have our testdouble recommendations for publishing/releasing to be documented here (fairly generically; again, this will be the default contributing doc for any testdouble repo that doesn't have its own.)
 -->
