Merge lp:~kim0/pyjuju/updating-faq into lp:pyjuju

[Ahmed Kamal]

Updating FAQ page

[Gustavo Niemeyer (niemeyer)]

That's a very nice list of questions, thanks Ahmed.

Here are a couple of suggestions, and +1!

[1]

17 + that can relate to other services running on different nodes. It is however
18 + planned to support multiple services per machine

Please reword the second sentence more simply and assertively as: "This was done just
because it was easier to get started. Ensemble will definitely support multiple
services per machine in the future."

[2]

+ Currently yes, however work is underway to enable deploying to LXC containers

s/yes, however work/yes. However, work/

review: Approve

[Ahmed Kamal (kim0)]

Changed applied

[lp:~kim0/pyjuju/updating-faq]

255. By Ahmed Kamal on 2011-06-16

Applying changes from merge 64679

[Jim Baker (jimbaker)]

+1, great addition to the docs, with just some minors:

[1]

Most of the answer paras do not end with periods, so please change that.

[2]

+ Ensemble itself is developed using python. However, writing formulas for

s/python/Python/ - the language, not the executable

[3]

+ on run-time. The Ensemble formula is then sent to the machine and hooks start

s/on/at/

review: Approve

[lp:~kim0/pyjuju/updating-faq]

256. By Ahmed Kamal on 2011-06-20

[trivial] Better grammar and typos

[Ahmed Kamal (kim0)]

Ack, your comments have been handled. I've pushed the updates

=== modified file 'docs/source/faq.rst'
--- docs/source/faq.rst	2011-05-05 13:38:04 +0000
+++ docs/source/faq.rst	2011-06-20 19:07:29 +0000
@@ -6,7 +6,7 @@
   The word ensemble could be defined as "an assemblage of parts or details
   (as in a work of art) considered as forming a whole". Ensemble assembles
   machines and software components and manages them as a whole, providing
-  service deployment and management, hence the name.
+  service deployment and management, hence the name
 
 Why is Ensemble useful?
 
@@ -29,9 +29,35 @@
 
 What language is Ensemble developed in?
 
-  Ensemble itself is developed using python. However, writing formulas for
+  Ensemble itself is developed using Python. However, writing formulas for
   Ensemble can be done in any language. All Ensemble cares about is finding a
-  set of executable files, which it will trigger appropriately.
+  set of executable files, which it will trigger appropriately
+
+Does Ensemble start from a pre-configured AMI Image?
+
+  No, Ensemble uses a plain Ubuntu image. All needed components are installed
+  at run-time. Then the Ensemble formula is sent to the machine and hooks start
+  getting executed in response to events
+
+Is it possible to deploy multiple services per machine?
+
+  Currently each service unit is deployed to a separate machine (ec2 instance)
+  that can relate to other services running on different nodes. This was done
+  to get Ensemble into a working state faster. Ensemble will definitely support
+  multiple services per machine in the future
+
+Is it possible to pass parameters to Ensemble formulas?
+
+  Tunables are landing very soon in Ensemble. Once ready you will be able to
+  use "ensemble set service key=value" and respond to that from within the
+  Ensemble formula. This will enable dynamic features to be added to formulas
+
+Does Ensemble only deploy to the Amazon EC2 cloud?
+
+  Currently yes. However work is underway to enable deploying to LXC containers
+  such that you are able to run Ensemble formulas on a single local machine
+  Also integration work with the `Orchestra <https://launchpad.net/orchestra>`_
+  project is underway to enable deployment to hardware machines
 
 How can I contact the Ensemble team?
 
@@ -45,5 +71,7 @@
 Where can I find out more about Ensemble?
 
   * Project Site: https://launchpad.net/ensemble
-  * Ensemble Documentation: http://j.mp/ensemble-docs
-  * Work Items: http://people.canonical.com/~niemeyer/budapest.html
+  * Ensemble Documentation: https://ensemble.ubuntu.com/docs/
+  * Work Items: https://ensemble.ubuntu.com/kanban/dublin.html
+  * Principia formulas project: https://launchpad.net/principia
+  * Principia-Tools project: https://launchpad.net/principia-tools