If9244c1819ab38676466d821be0b5104b6852c47 split out the developer docs
and a getting started page. This moved where the git-review installation
instructions were, resulting in the docs-contrib setup docs now going to
a page that no longer had the referenced header.
A separate change also moved the CLA information at some point. Link for
those details is also updated to the current location for CLA
information.
This updates the link to go to the current location for these
instructions.
Change-Id: I63914129b7c1458ba15c374d18250744e5a6c1d8
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>
OpenStack Foundation got renamed to Open Infrastructure Foundation,
follow the rename and update links as well.
Change-Id: I9f0f2cd6ebe53874baa02d07ddf6f2e52611119a
Remove ask.o.o references, replace one place with a link to Stack
Overflow.
ask.o.o is read-only now and unmaintained.
Change-Id: If2967a0d960002cc8fb80e6b40f28e42cebce552
This patch changes "native English- speakers"
to "native English speakers" at the 8 line
in doc/doc-contrib-guide/source/
non-native-english-speakers.rst
Change-Id: I815204a2b7121e90ac3452bdc32cecf9ecccfa31
New theme of docs (Victoria+) respects pygments_style.
Since we starts using Victoria reqs while being on Ussuri,
this patch ensures proper rendering both in Ussuri and Victoria.
Change-Id: I430184f65f1528dfa15b3e6a7810d062226e70e7
Switch to openstackdocstheme 2.2.0 version.
Update Sphinx version as well.
openstackdocstheme renames some variables, so follow the renames. A
couple of variables are also not needed anymore, remove them.
Set openstackdocs_auto_version to not version the documents and
openstackdocs_auto_name to use project as name.
Set openstackdocs_pdf_link to link to PDF files for the two
guides that build PDFs. 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.
Update copyright.
Change-Id: Ibd4844364d78abd135e5b094beba8f17503fab26
We are trying to produce richer reports using Goaccess and this includes
404 reporting. Link to that information.
Change-Id: I2a8bec9468da9f384e4d65ac951c4b18c2459543
With newer openstackdocstheme versions, many settings like
html_last_updated_fmt and latex are setup correctly and don't need to
setup in this repo anymore. We require a new enough version, so remove
the obsolete settings.
This repo now requires python 3, so remove python 2.7.x support.
Update hacking to current version supporting python 3.
Change-Id: I238eefeed275fe8115d0e253ca50d38086934b1e
We are migrating this server and don't believe this data is that
helpful. See Iccf24a72cf82592bae8c699f9f857aa54fc74f10.
Remove the link.
Change-Id: I2d53a4ea281717ba864b8cf699ec503998297f4e
jsoncheck was used for the old API guides and is not used anymore,
it is removed now from openstack-doc-tools, so remove it here as well.
Change-Id: I5c659e6c9d83eaf93f42488d0cd068861bd8af40
Use promote jobs for all publishing jobs, they work fine.
We don't use checkbuild/checklang anymore, remove it.
Keep checkbuild job until we have renamed training-guides to use the new
job.
Change-Id: I882fd90f07987358cd55e3a04a8f7ad0c746ce80
Most content from developer.openstack.org is now on docs.openstack.org,
update documentation for this.
A few links for the main index page and translated documents are not
updated yet, they will be updated once they are moved.
Change-Id: Ic7ff7a78c8b1e1ac2b2fef2398e700a59f84d779
Remove extra whitespace, line wrap overlong lines, convert too long
table to list-table, remove all setup.cfg files since we don't need them
anymore.
Change-Id: Icb0dc37c21927ecc6de163ae1b0245aea9b9c202
Import the api-quick-start from api-site repository so that it gets
published on docs.openstack.org.
Change-Id: Ic709ee736dda780fb71048a27158838a5806048e
Fix links that give 404: Replace with updated versions.
For ha-guide: Just drop the links, the guide has been changed so much
that the sections are completely different.
Change-Id: I428e8c5717fc20db8212621acfaf8728246e8e01
Current relative path resolution on template variables
(TOPDIR, CSSDIR, SCRIPTDIR, IMAGEDIR) cannot be used in css templates
which rendered css files are used on docsthemes.
This patch proposes to purposely use absolute URL paths
for publishdocs environment to prevent from side effects using
relative paths and apply the template variables to the tmpl files
which could not be applied previously by changing www-generator tool.
Also, changes doc-contrib-guide documentation properly.
Change-Id: I3ffda6cc6fa360a09dbcbba2ec924be054a88142
The recent OpenDev change changed a few URLs. Redirects are in place but
let's use the new URLs everywhere:
review.openstack.org moved to review.opendev.org, git hosting moved from
git.openstack.org to opendev.org.
Change-Id: I5cbcaed5a7ab0ab7994045a90e1a91e4a43c7611
The Contributor Guide has a good instruction now on account setup, link
to it and remove outdated instructions.
Remove now unsed graphic.
Change-Id: I840a15e17881cd61ee9496ca5126e96707689576
Closes-Bug: #1820198
As I sadly found out yesterday, new users will have to
run bindep on each individual repo they clone if they wish
to build project documentation. This is obvious to those
who have been working on the project forever, but this was
my first new computer in 5 years and I was pretty stumped -
couldn't work out why I needed liberasure to build swift
docs but here we are.
Change-Id: I27fb8ed862f3c2dfafba5f2d916a8c99fce7ec10
Currently deprecation badge headers just point back to the root of
the documentation for the latest stable release, so for example the
badge at the top of
https://docs.openstack.org/latest/user/index.html
just points to
https://docs.openstack.org/rocky/
It's useful to be able to quickly jump between different releases of
the same documentation page, but currently this requires hand-editing
URLs or many extra manual hops in the navigation trail. So
automatically generate the links, but only display them if the link
target exists.
Since the main portal page for each release already had a "More
Releases" dropdown, remove that to avoid two dropdowns on the portal
pages.
Change-Id: I2498f00a6c863d078a70289a655b0aa3958325ed
The arch-design guide has been removed, remove leftovers from
doc-tools-check-languages.conf and doc-contrib-guide.
Change-Id: Icfd067889d1af57e66faadd9c06e99ebd9fe2178
The rst2bash tool used the ".. path" syntax to update files. Since we're
not using rst2bash anymore, remove all of this.
Remove also the rst2bash documentation.
Change-Id: I7195cd3b566e9bac67452ec5174687e734fb53bc
We no longer build multiple conditional builds. Remove all the tooling
that enabled this along with references to said tooling.
Change-Id: Iea75f686797ab379c235ddbfb2f881b3f6376814
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
These were used by now-dead tooling. We can remove them.
Change-Id: I4b4ef694206249da8b98589b3026f2a2be501ee3
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
The ha-guide repo is being restored and owned by the Operations
Documentation SIG. Until the openstack-manuals content is removed,
patches merged to either repo will overwrite the content of the web
site.
Depends-on: https://review.openstack.org/#/c/603219/
Change-Id: Iabd74139d1d73016563d0cfd30cf8ed6a3e1fc57
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>