openstack/charm-deployment-guide
Code Issues Proposed changes

Convert README to markdown

Browse Source 
Convert the README file from reST to markdown
as the GitHub support for reST is poor (the
current links are broken) and it's more
consistent with the charms to have a README
in markdown.

The CG is being changed in the same way:
https://review.opendev.org/c/openstack/charm-guide/+/782845

Change-Id: I20107e9d8ea8945d7138f1c5d2609b46519d3d42
This commit is contained in:
Peter Matulis 2021-03-23 17:05:12 -04:00
parent b7f5823f27
commit dc42e0532a
3 changed files with 39 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
README.md Normal file
View File

@ -0,0 +1,38 @@
# OpenStack Charms Deployment Guide
[![tags][image-badge-cdg]][image-link-openstack-tags]
The [OpenStack Charms Deployment Guide][cdg] is the main source of information
for the usage of the [OpenStack Charms][openstack-charms].
## Building
To build the guide run this simple command:
tox
The resulting HTML files will be found in the `deploy-guide/build/html`
directory. These can be opened individually with a web browser or hosted by a
local web server.
## Contributing
Documentation issues can be filed on [Launchpad][lp-bugs-cdg].
This repository is under version control and is managed via the [OpenStack
Gerrit system][gerrit-openstack] (see the [OpenDev Developer’s
Guide][opendev-dev-guide]). For specific guidance on working with the
documentation hosted on [docs.openstack.org][link] please read the [OpenStack
Documentation Contributor Guide][openstack-doc-guide].
<!-- LINKS -->
[image-badge-cdg]: http://governance.openstack.org/badges/charm-deployment-guide.svg
[image-link-openstack-tags]: http://governance.openstack.org/reference/tags/index.html
[cdg]: https://docs.openstack.org/project-deploy-guide/charm-deployment-guide
[openstack-charms]: https://launchpad.net/openstack-charms
[lp-bugs-cdg]: https://bugs.launchpad.net/charm-deployment-guide/+filebug
[gerrit-openstack]: https://review.openstack.org
[opendev-dev-guide]: https://docs.openstack.org/infra/manual/developers.html
[openstack-doc-guide]: https://docs.openstack.org/doc-contrib-guide/index.html
[link]: https://docs.openstack.org

40
README.rst
View File

@ -1,40 +0,0 @@
=================================
OpenStack Charms Deployment Guide
=================================
.. image:: http://governance.openstack.org/badges/charm-deployment-guide.svg
:target: http://governance.openstack.org/reference/tags/index.html
The `OpenStack Charms Deployment Guide`_ is the main source of information for
the usage of the `OpenStack Charms`_.
Building
--------
To build the guide run this simple command:
.. code-block:: none
tox
The resulting HTML files will be found in the ``deploy-guide/build/html``
directory. These can be opened individually with a web browser or hosted by a
local web server.
Contributing
------------
Documentation issues can be filed on `Launchpad`_.
This repository is under version control and is managed via the `OpenStack
Gerrit system`_ (see the `OpenDev Developer’s Guide`_). For specific guidance
on working with the documentation hosted on https://docs.openstack.org please
read the `OpenStack Documentation Contributor Guide`_.
.. LINKS
.. _OpenStack Charms Deployment Guide: https://docs.openstack.org/project-deploy-guide/charm-deployment-guide
.. _OpenStack Charms: https://launchpad.net/openstack-charms
.. _Launchpad: https://bugs.launchpad.net/charm-deployment-guide/+filebug
.. _OpenStack Gerrit system: https://review.openstack.org
.. _OpenDev Developer’s Guide: https://docs.openstack.org/infra/manual/developers.html
.. _OpenStack Documentation Contributor Guide: https://docs.openstack.org/doc-contrib-guide/index.html

2
setup.cfg
View File

@ -2,7 +2,7 @@
name = charm-deployment-guide
summary = OpenStack Charm Deployment Guide
description-file =
README.rst
README.md
author = OpenStack
author-email = openstack-discuss@lists.openstack.org
home-page = https://docs.openstack.org/project-deploy-guide/charm-deployment-guide