<div dir="ltr"><div><div>Hey Jorge,<br><br></div>When trying to deploy your bundle I was working exclusively from the command line, I got your bundle from bzr branch and the package had just <b>two</b> files, the README.md and the bundles.yaml.  I was not aware that the Juju GUI had great instructions on how to deploy a bundle.  <br>
<br></div><div>If the use case only <b>one</b> file (bundles.yaml). I would suggest putting a short (one line?) comment with a link on where to get more information or a one line message that you deploy with:  juju quickstart bundles.yaml or use the Juju GUI "Import bundle" button.  <br>
<br></div><div>I see your point for using the auto generation that we already have, but I worry that is too long (25 lines in the GUI now).  The deploy instructions go into how to install the bundle from the GUI, quickstart, and deployer.  At some point we risk tldr and I would not suggest adding a 25 line comment to the bundles.yaml.<br>
</div><div class="gmail_extra"><br clear="all"><div><div dir="ltr">   - Matt Bruzek<br></div></div>
<br><br><div class="gmail_quote">On Wed, Mar 5, 2014 at 4:46 PM, Jorge O. Castro <span dir="ltr"><<a href="mailto:jorge@ubuntu.com" target="_blank">jorge@ubuntu.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I am working on submitting a mediawiki bundle:<br>
<a href="https://jujucharms.com/sidebar/search/bundle/~jorge/mediawiki-simple/5/mediawiki-simple/?text=mediawiki-simple" target="_blank">https://jujucharms.com/sidebar/search/bundle/~jorge/mediawiki-simple/5/mediawiki-simple/?text=mediawiki-simple</a><br>

<br>
In the GUI we provide a tab called Deploy which autogenerates<br>
deployment instructions. I love this because after editing individual<br>
deploy instructions in charms it's much nicer to have something that<br>
is not prone to human error and will always be correct.<br>
<br>
When Matt was reviewing my charm he noticed that I mention "After<br>
deployment you need to...", but the README has no "How do I deploy<br>
this bundle?" -- why would it, there's an entire autogenerated tab for<br>
that!<br>
<br>
But the README as a standalone file falls down. For obvious reasons I<br>
don't want to copy everything from the deployment tab into the README.<br>
On top of that when people want to share bundles there will be the<br>
usecase of people passing around just the bundle file without any of<br>
the corresponding documention:<br>
<br>
I thought of some ideas, so I thought I could bounce them off the list:<br>
<br>
- We could default to the Deploy tab in the GUI.<br>
- We could autogenerate a section on top of the README that points<br>
people more explicitly to the Deploy section.<br>
<br>
Also I think it would be worth investigating having the "export<br>
bundle" export everything the user will need instead of just the raw<br>
yaml file. Maybe zip up the bundle and cat the deploy instructions to<br>
the top of the README as part of exporting.<br>
<br>
We should also consider adding a comment to each bundle's exported<br>
file to the canonical location of it in the store in case I do get<br>
mailed a bundle with no instructions.<br>
<br>
Some food for thought!<br>
<span class="HOEnZb"><font color="#888888"><br>
--<br>
Jorge Castro<br>
Canonical Ltd.<br>
<a href="http://juju.ubuntu.com/" target="_blank">http://juju.ubuntu.com/</a> - Automate your Cloud Infrastructure<br>
<br>
--<br>
Juju mailing list<br>
<a href="mailto:Juju@lists.ubuntu.com">Juju@lists.ubuntu.com</a><br>
Modify settings or unsubscribe at: <a href="https://lists.ubuntu.com/mailman/listinfo/juju" target="_blank">https://lists.ubuntu.com/mailman/listinfo/juju</a><br>
</font></span></blockquote></div><br></div></div>