~ubuntu-branches/ubuntu/raring/charm-tools/raring

« back to all changes in this revision

Viewing changes to tests/create/python-apt/README.ex

  • Committer: Package Import Robot
  • Author(s): Clint Byrum
  • Date: 2012-07-23 13:52:08 UTC
  • mfrom: (1.1.8)
  • Revision ID: package-import@ubuntu.com-20120723135208-55bdkt9jj6kthm47
Tags: 0.3+151-0ubuntu1
* New upstream release.
* build-dep on python-yaml so charm proof tests can be run.
* buid-dep on python-apt and python-cheetah to enable new upstream
  tests.
* d/charm-tools.install: Install etc/* to pick up bash completion.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Describe the intended usage of this charm and anything unique about how
 
2
this charm relates to others here. 
 
3
 
 
4
This README will be displayed in the Charm Store, it should be either Markdown or RST. Ideal READMEs include instructions on how to use the charm, expected usage, and charm features that your audience might be interested in. For an example of a well written README check out Hadoop: http://jujucharms.com/charms/precise/hadoop
 
5
 
 
6
Here's an example you might wish to template off of:
 
7
 
 
8
Overview
 
9
--------
 
10
 
 
11
This charm provides (service) from (service homepage). Add a description here of what the service itself actually does. 
 
12
 
 
13
 
 
14
Usage
 
15
-----
 
16
 
 
17
Step by step instructions on using the charm:
 
18
 
 
19
    juju deploy servicename
 
20
 
 
21
and so on. If you're providing a web service or something that the end user needs to go to, tell them here, especially if you're deploying a service that might listen to a non-default port. 
 
22
 
 
23
You can then browse to http://ip-address to configure the service. 
 
24
 
 
25
Configuration
 
26
-------------
 
27
 
 
28
The configuration options will be listed on the charm store, however If you're making assumptions or opinionated decisions in the charm (like setting a default administrator password), you should detail that here so the user knows how to change it immediately, etc.
 
29
 
 
30
 
 
31
Contact Information
 
32
-------------------
 
33
 
 
34
Though this will be listed in the charm store itself don't assume a user will know that, so include that information here:
 
35
 
 
36
Author:
 
37
Report bugs at: http://bugs.launchpad.net/charms
 
38
Location: http://jujucharms.com
 
39
 
 
40
* Be sure to remove the templated parts before submitting to https://launchpad.net/charms for inclusion in the charm store.
 
41