<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"></head><body ><div>Gauvain, I think readers will already be familiar with cloud resources before they get to this book. You could point them to (or include) an overview from an existing book - end user guide? </div><div><br></div><div><br></div><div><div style="font-size:13px;color:#575757">Sent from my Verizon Wireless 4G LTE smartphone</div></div><div></div><br><br>-------- Original message --------<br>From: Gauvain Pocentek <gauvain.pocentek@objectif-libre.com> <br>Date:08/24/2014 3:15 AM (GMT-06:00) <br>To: openstack-docs <openstack-docs@lists.openstack.org> <br>Cc: <br>Subject: [Openstack-docs] HOT guide: audience <br><br>Hi,<br><br>I'm working on the HOT guide content and asking myself this question: <br>should we assume that the reader is already a cloud user and knows how <br>the OS "objects" work (required parameters to boot an instance, to <br>create a volume or an image, ...), or should we assume that the reader <br>is completely new to cloud computing and OS?<br><br>In other words, should we detail what the properties define and what <br>are the available values for each heat resource we document, or should <br>we assume that the user will know what we're talking about?<br><br>My guess is that people will not start using OS with orchestration, and <br>thus will understand the samples when they get to this doc.<br><br>See https://review.openstack.org/116496 to get an idea of what I have <br>in mind (WIP).<br><br>Opinions?<br><br>Gauvain Pocentek<br><br>Objectif Libre - Infrastructure et Formations Linux<br>http://www.objectif-libre.com<br><br>_______________________________________________<br>Openstack-docs mailing list<br>Openstack-docs@lists.openstack.org<br>http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs<br></body></html>