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? Sent from my Verizon Wireless 4G LTE smartphone -------- Original message -------- From: Gauvain Pocentek <gauvain.pocentek at objectif-libre.com> Date:08/24/2014 3:15 AM (GMT-06:00) To: openstack-docs <openstack-docs at lists.openstack.org> Cc: Subject: [Openstack-docs] HOT guide: audience Hi, I'm working on the HOT guide content and asking myself this question: should we assume that the reader is already a cloud user and knows how the OS "objects" work (required parameters to boot an instance, to create a volume or an image, ...), or should we assume that the reader is completely new to cloud computing and OS? In other words, should we detail what the properties define and what are the available values for each heat resource we document, or should we assume that the user will know what we're talking about? My guess is that people will not start using OS with orchestration, and thus will understand the samples when they get to this doc. See https://review.openstack.org/116496 to get an idea of what I have in mind (WIP). Opinions? Gauvain Pocentek Objectif Libre - Infrastructure et Formations Linux http://www.objectif-libre.com _______________________________________________ Openstack-docs mailing list Openstack-docs at lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140824/4540c387/attachment.html>