42 lines
1.5 KiB
ReStructuredText
42 lines
1.5 KiB
ReStructuredText
.. _dg_files:
|
|
|
|
============================
|
|
Use recommended file formats
|
|
============================
|
|
|
|
Each diagram should include files in the following formats:
|
|
|
|
* Raster, always Portable Network Graphics (``.png``).
|
|
The documentation build process uses these files.
|
|
* Vector, typically Scalable Vector Graphics (``.svg``).
|
|
Most illustration tools support editing these files.
|
|
* Original, typically the native format of the tool.
|
|
|
|
At a minimum, each diagram must include a ``.png`` and ``.svg`` file.
|
|
|
|
Furthermore, any outside stencils or objects added to a diagram
|
|
should also be ``.svg`` files, so that reviewers can edit individual elements
|
|
of the diagram.
|
|
|
|
.. Note:: Using ``.svg`` files for individual elements may cause rendering
|
|
issues when editing the diagram in a different tool than the one
|
|
from which the diagram was originally created.
|
|
|
|
File names
|
|
~~~~~~~~~~
|
|
|
|
Contributors must create unique and meaningful file names to
|
|
differentiate between diagrams. An example of this is the name
|
|
``cg-workflow-digram.png``. ``cg`` indicates that this diagram belongs
|
|
in the contributor guidelines, the acronym created by taking
|
|
the first letters of the OpenStack book name. ``workflow-diagram.png``
|
|
provides a description of what the diagram is about, as well as the
|
|
file type extension.
|
|
|
|
Other file guidelines
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
* Files must be saved with a transparent background.
|
|
* Files must be saved in a landscape document style.
|
|
* Diagram width and height should be no more than 900pt.
|