Code conventions

Follow these guidelines:

  • Do not use “-y” for package install

    When you describe package installation, do not use the -y option. Instead, use apt-get install package, yum install package, or zypper install package.

  • Use “–option ARGUMENT”

    The OpenStack CLI supports both --option ARGUMENT and --option=ARGUMENT. In technical publications, use --option ARGUMENT.

  • Use capital letters with underscores for parameters

    When you write parameters in an example command, use capital letters for the parameters, with underscore as a delimiter. For example:

    $ openstack user create --project PROJECT_A --password PASSWORD USERNAME
    

    If necessary, describe the parameters immediately after the example command block. For example, for the PASSWORD parameter:

    Replace ``PASSWORD`` with a suitable password.