From fa29d183b7b20fecaac979b26f153f16a0690a95 Mon Sep 17 00:00:00 2001
From: Rob Sherwood <rob.sherwood@bigswitch.com>
Date: Fri, 5 Feb 2016 10:24:14 -0800
Subject: [PATCH] Skeleton guide for development in our Make system

---
 docs/dev.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 docs/dev.md

diff --git a/docs/dev.md b/docs/dev.md
new file mode 100644
index 00000000..77130458
--- /dev/null
+++ b/docs/dev.md
@@ -0,0 +1,16 @@
+==== FIXME ===
+Finish this doc
+
+== Adding a new package
+
+* Create most of the files in the 'any' architecture for cross compiling
+* Copy the directory structure from an existing package
+    * APKG.yml goes into the $(ONL)/packages/base/any/foo/ directory
+    * PKG.yml goes into the $(ONL)/packages/base/$ARCH/foo directory
+        * Create for each $ARCH you intend to support
+* Put code in $(ONL)/packages/base/any/foo/src
+* Put package specific Makefiles in $(ONL)/packages/base/any/builds
+
+* Run `make rebuild` in $(ONL)/packages/base/$ARCH/foo to rebuild the package cache
+    * particularly if you see an error like:
+      """ERROR:onlpm:'Package all does not exist.'"""