c80cf9ec58
The table of contents for our developer guide does not show due to the fact that it is past the first sub-header. Change-Id: I8459a4949e3e4822b0a3cd4f163475d2c60b0f2e
45 lines
1.0 KiB
ReStructuredText
45 lines
1.0 KiB
ReStructuredText
Developer Documentation
|
|
=======================
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
design
|
|
components
|
|
invocation
|
|
caches
|
|
developing_elements
|
|
dib_lint
|
|
stable_interfaces
|
|
|
|
This documentation explains how to get started with creating your own
|
|
disk-image-builder elements as well as some high level concepts for element
|
|
creation.
|
|
|
|
Quickstart
|
|
----------
|
|
|
|
To get started developing with ``diskimage-builder``, install to a
|
|
``virtualenv``::
|
|
|
|
$ mkdir dib
|
|
$ cd dib
|
|
$ virtualenv env
|
|
$ source env/bin/activate
|
|
$ git clone https://git.openstack.org/openstack/diskimage-builder
|
|
$ cd diskimage-builder
|
|
$ pip install -e .
|
|
|
|
You can now simply use ``disk-image-create`` to start building images
|
|
and testing your changes. When you are done editing, use ``git
|
|
review`` to submit changes to the upstream gerrit.
|
|
|
|
|
|
Finding Work
|
|
------------
|
|
|
|
We maintain a list of low-hanging-fruit tags on launchpad:
|
|
|
|
* `https://bugs.launchpad.net/diskimage-builder/+bugs?field.tag=low-hanging-fruit`
|
|
<https://bugs.launchpad.net/diskimage-builder/+bugs?field.tag=low-hanging-fruit>
|