Merge branch 'develop'

docs/index.md

@@ -11,4 +11,6 @@ compiling, and deploying your smart contracts easy.
  - [Testing](testing.md)
  - [metafile.json](metafile.md) - The JSON file that contains information about deployments and project state
  - [networks.yml](networks.md) - The Ethereum JSON-RPC network configuration file
- - [SolidByte Development](development.md)
+ - [SolidByte Development](development.md)
+ - [Project Directory Structure](structure.md)
+

docs/structure.md

@@ -0,0 +1,44 @@
+# Project Structure 
+
+The project directory structure pretty straight forward.  Most of this will be created by `sb init` with a simple template.  This example is what is created by the `erc20` template:
+
+    project_directory/
+        |- build/  # Files created by the compilers, including contract ABIs and their compiled bytecode.
+        |- contracts/  # Solidity and/or Vyper contract source files
+            |- ERC20.sol
+            |- IERC20.sol
+            |- SafeMath.sol
+        |- deploy/  # Your deployment scripts.
+            |- __init__.py
+            |- deploy_main.py
+        |- tests/  # Contains your pytest tests to test your contracts
+            |- __init__.py
+            |- test_erc20.py
+        |- networks.yml  # Network/node connection configuration
+        |- metafile.json  # Project state
+
+For further detailed information, see below.
+
+## build/
+
+This directory should be pretty much hands-off and completely managed by solidbyte.  Referencing these files may be useful, but arbitrarily changing anything may cause unexpected behavior.  There's no real reason to keep this directory in version control.
+
+## contracts/
+
+This directory contains all of your contract source files.  They can be Vyper or Solidity or a mix of both if you prefer.  The directory structure under this can be whatever you want.
+
+## deploy/
+
+`deploy/` contains your [deployment scripts](deployment.md).
+
+## tests/
+
+This contains your [pytest scripts](testing.md).
+
+## networks.yml
+
+This file contains [your connection configuration](networks.md).
+
+## metafile.json
+
+This is the file Solidbyte uses to keep track of your project state.  Things like the default account, and known deployments of your contracts.  Generally, you probably shouldn't fiddle with this file and it's a great idea to keep this file in version control if working in a team.  For more information, see the [metafile documentation](metafile.md).