Changed facts to be called metric library

SUMMARY.md

@@ -18,7 +18,7 @@
   * [Financial Functions](functions/finance_functions.md)
   * [Distributions](functions/distributions.md)
 * [Organizations](organizations.md)
-* [Facts](facts.md)
+* [Global and Organization Metrics](global_and_organization_metrics.md)
 * [Feedback](https://productpains.com/product/guesstimate)
 * [Release Notes](release_notes/README.md)
   * [4-5-2016](release_notes/4-5-2016.md)

global_and_organization_metrics.md

@@ -0,0 +1,77 @@
+# Global and Organizational Metrics
+
+Most metrics made in a model are only available in that model.  These can be called **local** metrics.  However, there are also some **global** metrics available in all Guesstimate models, and other **organizational** metrics available to organizational models.
+
+## Global Metrics
+
+Guesstimate maintains a database of certain global metrics that can be used in any function in any model. Right now, this
+dataset is limited to city population sizes, for a select, but extensive list of cities. To use these metrics, simply type
+an '@' sign, followed by the city name, then a '.' followed by the word, 'population' within a functional form, like
+this:
+
+![Global metrics use expressions like '=@Chicago.population'](./assets/Global Facts.png)
+
+## Organizational Metrics
+
+
+Have a few similar metrics that are used in multiple sheets?  You can use organization metrics to have some constants that will be
+similar among all of your organization's models.
+
+Organizational metrics are stored in what is called the organization **metric library.**
+All organizational metrics are completely private and are only available for use in private models. Organizational metrics are available only to organizations with private plans.
+
+
+### Creating & Editing Organizational Metrics
+#### Static Metrics
+
+Each metric has a ** value**, **name**, and **hashtag**. 
+
+The **value** is a numeric value that represents the current expectation or known value.  For instance,
+
+``34.8``,
+
+or
+
+``40K to 43K``.
+
+The value can be a data input. It cannot be a function. Also, if this is a range, you will not be able to choose between
+the standard distribution options for that range.
+
+The **name** is whatever you want to use to refer to the metric. It is only used for your own reference.
+
+The **hashtag** is what you can use to refer to the organizational metric inside of a local metric in a model. As opposed to global metrics,
+which are referenced with the `@` symbol, organizational metrics are referenced via a automatically generated or user-set
+hashtag, as shown below:
+
+![Organization metrics are referenced via the hashtag](./assets/Organization Facts.png)
+
+Organizational metrics can be simply added or edited. They are findable on the organizations' page. We suggest being careful with
+deleting these: while this is possible, if you have a model that uses that metric, that model may break.
+
+#### Exported Metrics
+
+Organizational metrics can also be exported from metrics within private models within your organization. To export a metric,
+simply open the metric sidebar and select 'Export':
+
+![Export a local Metric to an organizational Metric via the Metric Sidebar](./assets/Export Button.png)
+
+Only named metrics containing functions can be exported. Once a metric has been exported to the organizational library, deleting either that
+local metric or that organizational metric will delete the associated organizational metric. Furthermore, the metric card is marked with an _exported_ symbol in
+the upper right corner of the card, as below:
+
+![Exported metrics are specially demarcated](./assets/Exported Fact.png)
+
+Exported organizational metrics take on the name of the owning metric, an automatically assigned hashtag based on that name, and the
+value of that metric.  The resultant metric are kept in-sync with the owning model, even if upstream metrics used in the
+model change. In this way, you can connect disparate metrics together via models that relate one metric to another. You can
+explore these dependencies via the _Metric Graph_, accessible on the organization page. The metric graph also will show
+which models within your organization import and export which library metrics, even if those models do not export metrics of their own.
+
+![The metric graph displays the dependency network of your organization's facts.](./assets/metric_graph.png)
+
+### Using Organizational Library Metrics
+
+Organizational metrics are simple to use in models.  In a function, type the hashtag that represents an organizational metric in order to refer to it.
+This should auto-complete, so after typing the first few characters, you can click **TAB** to complete the word.
+
+Organizational metrics are still an experimental feature; if you encounter any issues in their usage, please contact us.