Commit Graph

29 Commits

Author SHA1 Message Date
Sharpz7 c5cf606339 [codespell] Fixing Spelling Mistakes
This is the first in a series of commits to add support for codespell. This is continuning the process completed in ironic-python-agent.

Future Commits will add a Tox Target, CI support and potentially a git-blame-ignore-revs file if their are lots of spelling mistakes that could clutter git blame.

Change-Id: I1efadb54995b0f5a2a8b672f017831a3009cb6d2
2024-01-29 21:08:48 +00:00
wangjiaqi07 4d89480047 remove unicode from code
Change-Id: I7451a1a680bf3b60472702f1c6da8890f916ab16
2022-08-19 14:25:01 +08:00
Iury Gregory Melo Ferreira 0dd2333634 Remove horizon from doc requirements
Change-Id: I1149b67cc6d4f7043392e83b1e2e9f18e14d4ea4
2021-09-01 10:28:12 +02:00
HeroicHitesh 258bd56eff Remove testr
* Remove .testr.conf as it's not used anywhere
* Remove .testrepository from .gitignore
* Use 3.18.0 as the minversion for tox
* Add 17.1.0 as lower bound for 'horizon' package in
  doc/requirements.txt

Signed-off-by: HeroicHitesh <email.hiteshkumar@gmail.com>
Change-Id: I19741f36d0bd08e49faa5be222adce9eb61b41a5
2021-05-21 19:11:30 +05:30
Hervé Beraud cae8625487 drop mock from lower-constraints and requirements
The mock third party library was needed for mock support in py2
runtimes. Since we now only support py36 and later, we don't need it
in lower-constraints and requirements.

These changes will help us to drop `mock` from openstack/requirements

Change-Id: Ia3b71f68ba1714b7b7254119c1b610b1390f7059
2020-06-09 01:16:20 +02:00
Andreas Jaeger beb50811db Switch to newer openstackdocstheme and reno versions
Switch to openstackdocstheme 2.2.0 and reno 3.1.0 versions. Using
these versions will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems

Update Sphinx version as well.

Set openstackdocs_pdf_link to link to PDF file. Note that
the link to the published document only works on docs.openstack.org
where the PDF file is placed in the top-level html directory. The
site-preview places the PDF in a pdf directory.

Set openstackdocs_auto_name to use 'project' as name.

Change pygments_style to 'native' since old theme version always used
'native' and the theme now respects the setting and using 'sphinx' can
lead to some strange rendering.

Remove docs requirements from lower-constraints, they are not needed
during install or test but only for docs building.

openstackdocstheme renames some variables, so follow the renames
before the next release removes them. A couple of variables are also
not needed anymore, remove them.

Change pygments_style to 'native' since old theme version always used
'native' and the theme now respects the setting and using 'sphinx' can
lead to some strange rendering.

See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html

Change-Id: I497fa0cbaedba4be199a7bd0dc86f686c0858ac0
2020-05-21 09:22:36 +02:00
Madhuri Kumari 318ed8bc9d Drop python 2.7 support and testing
OpenStack is dropping the py2.7 support in ussuri cycle.

ironic-ui is ready with python 3 and ok to drop
the python 2.7 support.

Complete discussion & schedule can be found in
- http://lists.openstack.org/pipermail/openstack-discuss/2019-October/010142.html
- https://etherpad.openstack.org/p/drop-python2-support

Ussuri Communtiy-wide goal - https://review.opendev.org/#/c/691178/

Change-Id: Iaedcd8e73871583e4dc16860a81eb7351ffae0a2
2019-11-27 17:49:52 +00:00
Kaifeng Wang c28503f70e Build pdf doc
The is one of community goals that each project could produce a
single PDF file. The pdf should be in the output of openstack-tox-docs
job.

TeX packages are required to build PDF locally, following is recommended:

* inkscape
* texlive-latex-base
* texlive-latex-extra
* texlive-fonts-recommended

More about the goal:
https://governance.openstack.org/tc/goals/train/pdf-doc-generation.html
https://etherpad.openstack.org/p/train-pdf-support-goal
https://etherpad.openstack.org/p/pdf-goal-train-common-problems

Change-Id: Ib7379bb5066ede1956424dc92cf302ec22053f21
2019-09-06 08:48:51 +08:00
zhouxinyong ce04b57f14 Update various links in the documentation
Co-Authored-By: Dmitry Tantsur <dtantsur@redhat.com>
Change-Id: I0d8ad20827142d2d2cc9c453768b0356860f1255
2019-09-04 14:24:53 +02:00
pengyuesheng b68684a3ef Follow the new PTI for document build
The detail is described in the following links:
https://governance.openstack.org/tc/reference/project-testing-interface.html
http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html

Change-Id: I6aba9d03ad3cadba7bbd41ea32091a751889db17
2019-07-02 14:15:19 +08:00
zhulingjie 6670f4339a Replace git.openstack.org URLs with opendev.org URLs
Change-Id: I8a306d1b42cb25296960f88158eb8c8e21b0be08
2019-04-24 01:13:36 +08:00
melissaml 7dd859d885 Change openstack-dev to openstack-discuss
Mailinglists have been updated. Openstack-discuss replaces openstack-dev.

Change-Id: I82bae1810c11fe558dc5de0074d8e59f93c34630
2018-12-14 20:36:24 +08:00
Zuul 5497084674 Merge "Fix installation docs" 2018-04-11 12:23:25 +00:00
Zuul e7ee92fb9a Merge "Change Launchpad references to Storyboard" 2018-04-11 12:23:08 +00:00
Julia Kreger 1f9a77de21 Fix installation docs
Seems somewhere along the line the install
formatting got mangled.

Fixes formatting. Also fixes the gitignore
for the python api doc folder.

Story: #1737898
Task: #11683

Change-Id: I1b8848c5703ab3d6434d47138c11309bdd83b2cd
2018-03-28 12:00:33 -07:00
Julia Kreger d2977a9f53 Change Launchpad references to Storyboard
Change-Id: I737eb0828e398438acadacba7b149cf0b3f41e85
2018-03-26 14:21:44 -07:00
Andreas Jaeger a368c4cdf6 Fix docs build
With the updated docs build job, doc building is failing since
DJANGO_SETTINGS_MODULE is not set. Define it properly.

Change-Id: Idc43f59bf6d04705a30c02fd316f50706aacd4ef
2018-01-03 11:31:05 +01:00
Julia Kreger b8ce8be233 Add python api docs to contributor docs
In addition to adding that configuration,
a portion of the documentation conf.py file
needed to be updated from the horizon panel
cookiecutter repository.

Change-Id: I39b1d8718b1de51093a10f50dd04a5ff1d75dd46
2017-07-18 13:47:42 +00:00
Julia Kreger c83c090631 Move ironic-ui contributor docs
Change-Id: I8ead55a8d122a37212d9f53bb40ba3c95eac030c
2017-07-11 14:04:54 +00:00
Julia Kreger 1113e2eaae Moving ironic-ui install content to install folder
Change-Id: I6b80cf46bec09ad66ed189e08b79e0df10ca6850
2017-07-04 12:57:44 +00:00
Shu Muto 2562821c71 Switch from oslosphinx to openstackdocstheme
As part of the docs migration work[0] for Pike we need to switch to use
the openstackdocstheme.

[0]https://review.openstack.org/#/c/472275/

Change-Id: I560d46158edf98eb64ab524fc6af77cf95c6c1bc
2017-06-29 18:30:42 +09:00
Zhenguo Niu de0e12581d Replace ironic with ironic-ui in contributing doc
In contributing doc, some links and informations are still for
ironic, we should change to use ironic-ui.

Change-Id: If75b79927e9cbb269057dc5311ef8f5ccc6a1f32
2017-02-14 10:25:12 +08:00
Zhenguo Niu c1560dea64 Correct horizon dir in installation doc
Change-Id: I20671a4f60728f74e3bfb41a9b022cd1baa10fb2
2017-02-10 11:11:27 +08:00
Julia Kreger 8d6fcd819c Refactor ironic-ui documentation to remove warnings
Warnings, such as those caused by the README.rst file's
inclusion of an externally hosted file cause the default
sphinx job to fail. Removed the link, and cleaned up the
documentation formatting to make it more clear moving
forward.

Change-Id: I55afe786b794a6cb179a3de20b5f4e0f3f8072c8
2016-12-12 23:43:49 +00:00
Elizabeth Elwell 1417ff4c1d Added release notes for 2.1.0 release
Also added release notes link to main developer documentation page.

Change-Id: Ia554b08045f84f695fbb6e0c2a3781f5bcede203
2016-09-28 15:28:08 +01:00
Xu Ao 8f554eb3a9 Fix a mistake in the document about the filepath
In the documents, the path of the _2200_ironic.py
should be 'ironic_ui/enabled' but not 'ironic-ui/enabled'.

doc_urls:
http://docs.openstack.org/developer/ironic-ui/readme.html
http://docs.openstack.org/developer/ironic-ui/installation.html


TrivialFix

Change-Id: I2ced663718547b3aa55d8ad277775650078b0bfa
2016-07-27 10:39:24 +00:00
Elizabeth Elwell ae2172f511 Updated ironic-ui documentation
Updated developer documentation to include introduction to the
ironic-ui and links to other relevant docs.

Change-Id: I82086e0c9e8011cfcaa13d4057ab2f828c1c0515
2016-06-29 12:52:29 +01:00
Elizabeth Elwell 797f898d93 Corrected copyright details for the project
Change-Id: I5803eb67d1690d552245026f863155667535083f
2016-01-21 12:20:43 +00:00
Elizabeth Elwell 728fed6ee9 Added cookiecutter files
In patch amends have also renamed internal ironic-ui folder to ironic_ui to
ensure not read mathematically to pass pep8 tests. Also added global requirements.

Change-Id: I5689f762194291bbad6070350486d397c376364a
2016-01-20 19:00:52 +00:00