53 Commits (7cd0ee463405ea99123dd1cfcb09837bda52f0df)

Author SHA1 Message Date
YuehuiLei c33e771b4e Add xena directory for specs
Change-Id: I9e7452c9f5bec5f5b0b5e288f5af8a0463a23840
2 years ago
Brian Rosmaita 6de8257026 Fix redirects
The current paths need '/openstack/glance-specs' prepended to them.
(This was verified by fungi manually editing the deployed .htaccess
file on the specs website, and also by cinder change

Change-Id: I94ab1898b83fe708703dccc49df83bae3cd12fc6
3 years ago
Brian Rosmaita 47b9c32438 Remove Images API v1 user guide
Version 1 of the Images API was removed in Rocky by Change
Ia086230cc8c92f7b7dfd5b001923110d5bc55d4d.  This patch removes
the version 1 "user guide" documentation.

Change-Id: Idc4986671df623f4e5a953c49918be66b973aada
3 years ago
Abhishek Kekane d7bbf47795 Create specs directory for Wallaby cycle
Change-Id: I1e856c5a31961c721231043891d6bdf058b0b552
3 years ago
Andreas Jaeger 2d2d7baf03 Switch to newer openstackdocstheme version
Switch to openstackdocstheme 2.2.1 version. Using
this version will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems

Update Sphinx version as well.

Disable openstackdocs_auto_name to use 'project' variable 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.

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.

See also

Change-Id: If08d763c2c0f09faa61c327ab64f1ad7b1549262
3 years ago
Abhishek Kekane c73bc4a2ec Corrections based on comments on victoria specs directory patch
Follow up patch to fix the minor comments on base patch [1].

[1] https://review.opendev.org/#/c/717665

Change-Id: I76e0fdb8af559e65dce8a0f813f284d0fce1e772
3 years ago
Zuul 842f3ca5c2 Merge "Create specs directory for Victoria cycle" 3 years ago
Abhishek Kekane 4fef6d1812 Create specs directory for Victoria cycle
Change-Id: I3c94005ef8d8218e15636b1bb80a2269719035ad
3 years ago
Andreas Jaeger 80c60a7bd6 Cleanup py27 support and docs
Make a few cleanups:
- Remove obsolete sections from setup.cfg
- Switch to using sphinx-build
- Cleanup doc/source/conf.py to remove now obsolete content.
- Use newer openstackdocstheme version
- Remove install_command from tox.ini, the default is fine

Change-Id: I3287169563c44d05cfab0329af9756f6de4f885c
3 years ago
Abhishek Kekane 7b296e38d3 Create specs directory for Ussuri
Change-Id: I05185e69be13449777ead9247de370f9589e38e1
4 years ago
Erno Kuvaja d9fd388bda Move Stein implemented specs to 'implemented'
Moves the appropriate specs from 'approved' to 'implemented' and
sets up the http redirects so that current links to the specs won't

Change-Id: I21834bf265fab97332a17fbca5f3bad89ae1dc0e
4 years ago
Abhishek Kekane 03f62891e3 Create specs directory for Train
Change-Id: Ic483bcc3d25903d69efbd77b31995de27040a5e4
4 years ago
zhangbailin 038f86cc55 Create specs directory for Stein
Change-Id: I04888049bed442fd0c744c1abd715425d5680807
5 years ago
Brian Rosmaita 1bac78965a Move Rocky implemented specs to 'implemented'
Moves the appropriate specs from 'approved' to 'implemented' and
sets up the http redirects so that current links to the specs won't

Change-Id: Ifb819dcc01a643ba39962f47c7165bafa624392e
5 years ago
Brian Rosmaita 0cd9928970 Move specs implemented in Rocky-{1,2} milestones
The owner_is_tenant option was deprecated in R-1.
The pending-delete revert was merged for R-2.
This patch moves the specs to 'implemented' and sets up redirects
from 'approved' so links won't be broken.

Change-Id: I6482178dfbd4be00d997b80c068f465875103cff
5 years ago
bhagyashris f8736b39af Introduce db sync check feature
Lite-spec for a dry-run option for db upgrades in glance-manage.

This spec is moved from /specs/untargeted/glance/lite-spec-db-sync-check.rst
to /specs/queens/implemented/glance/lite-spec-db-sync-check.rst because it was
implemented by change I1e0b02d615690f65a17b4ccfe4e4a72cc9e15ada

Change-Id: Ice1ab9657e236d969df50016a3b47a893e6aff0c
5 years ago
Andreas Jaeger d26263e303 Fix broken .htaccess
This lead to an internal server error, hope that's the only needed

Change-Id: Ic4331767a31a7021f8ef592ed3dc1f3fc26056aa
5 years ago
Brian Rosmaita ef0df98f9e Close out queens in glance-specs repo
Update queens specs from 'approved' to 'implemented' or to
rocky/approved or to untargeted, define the redirects, and
make appropriate changes on the supporting pages.

Change-Id: I48aa6a2f11831ffc544e8b02b0bfdb80aa51d3e2
5 years ago
Erno Kuvaja c70688ce6e Client v1 support removal update
Did not happen in Queens, lets try this again in Rocky.

Change-Id: Ib2d9f737a718353d399deb475378b1b6b9c933f0
5 years ago
Brian Rosmaita c041db7f85 Update specs repo for Queens
Move the implemented Queens specs from 'approved' to 'implemented'
and set up redirects so links to 'approved' won't break.

Change-Id: I6f228424d677f1b4c47b6784732c0ab10cd2aa47
5 years ago
Zuul b6332763dd Merge "Move implemented spec to 'implemented'" 5 years ago
Brian Rosmaita 803776bab4 Un-comment get_html_theme_path()
One of the changes in https://review.openstack.org/#/c/523233/ was
commented out by mistake.  This patch corrects that.

Closes-bug: #1735935
Change-Id: I30bb1403ad4300909ef314f3b9402fc360c30ec6
6 years ago
Brian Rosmaita fe26e476f7 Move implemented spec to 'implemented'
Update the specs repo to indicate the Q-1 implementations.
This includes moving the spec, adding a redirect so the old
URL doesn't break, and adding a 'whereto' test.

Change-Id: I8aac14f306f35d14ca06ca742f556ef8afb866fe
6 years ago
Doug Hellmann daaba42170 add whereto for testing redirects
Set up whereto so that any redirect rules added to the .htaccess file
can be tested.

Change-Id: I2238a2163c26b7df9c6a3dfaf0f8701631ff2cc5
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
6 years ago
Brian Rosmaita 46fa54dd05 Update glance-specs to use openstackdocstheme
Maintenance on oslosphinx ended with the Pike release.  This
patch includes the following changes:
* switch to openstackdocstheme
* set context options for openstackdocstheme
  - glance-specs doesn't have its own bug tracker, so config
    to create bugs in the glance bug tracker with tag 'glance-specs'
* update requirements file
* update setup.cfg to use warning-is-error
* update four specs whose warnings were previously ignored
* add an '_extra' directory with stub .htaccess file
* configure docs build to include '_extra'
* update build command in tox.ini

Change-Id: I4da477fd39685a22fb4ef9d702af9b9a79bda0c2
6 years ago
Brian Rosmaita 7dba189b29 Add Queens priorities
Adds the Queens priorities list.  Also moves the old priority lists
to their own archive page in order to de-clutter the specs landing

Change-Id: I4b54f689575f3420ccc78670d71b26a8fe25f9f3
6 years ago
Brian Rosmaita 19f50813a7 Open specs repo for Rocky
Glance is now in a specs proposal freeze for Queens, so new specs
must be proposed for Rocky.  This patch sets up the directories
and introduces a new spec-lite template to replace the old strategy
of having a single file containing all lite specs.  It also reorganizes
the index page slightly to make the current cycle's specs more

Change-Id: I85b096fc0c99a70e3ad0d7f8727b7d5ab679c95b
6 years ago
melissaml 05f5daa2c5 Fix doc generation for Python3
Fix the Sphinx html_last_updated_fmt for Python3.
The html_last_updated_fmt option is interpreted as a
byte string in python3, causing Sphinx build to break.
This patch makes it utf-8 string.

Change-Id: I98ffb4f1084e8f1dc953d81b3959bfe704b52fab
6 years ago
Brian Rosmaita 459ad922c9 Introduce 'untargeted' specs
This commit adds an 'untargeted' directory to hold orphaned specs
that were approved but aren't being worked on.  A new index.rst is
added explaining the idea, and adjustments are made to other
appropriate index pages.  Additionally, one glanceclient spec from
liberty was stuck in a non-release-name directory; it was moved to
the liberty directory, which in turn was slightly reorganized to
accommodate both glance and glanceclient specs.

Change-Id: I074fc782eca1c3e3c9a1c504501973300741b110
6 years ago
Brian Rosmaita d70f290561 Prepare specs repository for Queens
Add directories, index file, template symlinks, and lite-specs
templates for Queens specs.

Change-Id: Idc9a166ea558e5af72b7a36fb0b4167ce235c193
6 years ago
Brian Rosmaita 1736a54244 Prepare specs repository for Pike
Add directories, index file, and template symlinks for Pike specs.

Change-Id: Ic3377973e50ce1d15b51b7e93d8f4b389ec73883
6 years ago
Brian Rosmaita 83ad95084a api-docs: deprecate the Images v1 API
This patch updates the "narrative" Images v1 API docs for the
Newton release by adding a deprecation note to each page.  That
way the note will be seen even if someone uses a direct link to
one of the pages.

The Images v1 API was deprecated with commit

Change-Id: I62315efc12ee05aea5f55d020006cbb2ad279876
Partial-bug: #1618495
7 years ago
Nikhil Komawar 9f7278d435 Start Ocata specs proposals
Some of the Newton specs did not get enough attention from cores
during the cycle. Let's start the Ocata folder for starting planning on
the specs for next cycle.

This needs to be started/merged in Newton for people to start planning
on writing specs and then help the glance team and community
determine/plan work for Ocata.

Co-Authored-By: Nikhil Komawar <nik.komawar@gmail.com>
Co-Authored-By: Brian Rosmaita <brian.rosmaita@rackspace.com>

Change-Id: I16d1dd18c3efceb2245239f9c95483e717c70c4d
7 years ago
Jenkins 3ae74a036d Merge "Replace deprecated library function os.popen() with subprocess" 7 years ago
Ubuntu b867945734 Add Newton Files
This adds the place to put specs for Newton. As one is currently

Change-Id: Ice8c58b5c40237b09562812180223621c49eecdf
7 years ago
Harshada Mangesh Kakad 040ecfe5dd Replace deprecated library function os.popen() with subprocess
os.popen() is deprecated since version 2.6. Resolved with use of
subprocess module.

Change-Id: I761503490899c47f875e4ca07c4e941eb53390b8
Closes-Bug: #1529836
7 years ago
Flavio Percoco ebd9b8f977 Use a section for the server and the client
Instead of splitting specs per cycle, let the index point to the cycle
index and use 2 sections: one for Glance and another for glanceclient.

Change-Id: I7959a2128b9e3b3cd92e03b125052db85c97a9cf
7 years ago
Flavio Percoco 5e0f796332 Reduce the verbosity in the index page
Change-Id: I5acd7b73e02fbe7a836cb1fa5c8af61728a695d1
7 years ago
Flavio Percoco 864136bc19 Add Glance priorities for Mitaka
For this cycle, I believe we should be more strict on what is/isn't a
priority. Considering the latest feedback from the community and our
current team, we ought to be very careful.

This list does not exclude other works. It just clarifies what
the teams priorities are and where most of the time should probably go.

Also, this list does not define features and it doesn't replace specs.
Specs *must* be written and they'll be referenced in this list.

Change-Id: I312d0dcd815da10f083f2fb2a673f7c192c231f4
8 years ago
Deepti Ramakrishna 2616905dc9 Mitaka spec folder for tracking proposed specs
Now that the name of the new milestone has been decided, it is time to create
a folder to house specs for it.

Change-Id: Ic13e5f89f600d3d48f4f8c16576d4a5722e1110a
8 years ago
Jamie Lennox 780845f1ea Add session-object blueprint for glanceclient
Add blueprint for using a keystoneclient session object within

Implements: bp session-objects
Change-Id: I4f23b36b4b68f3b9971042c96d7f5f5ab47e500f
8 years ago
Erno Kuvaja c6b0603a3d Liberty spec folder for tracking specs proposed
As we're hitting to Kilo feature freeze it's time to bring in Liberty

Change-Id: Ia2e0133a2a223d04dec1be3f136fa4915f74bf02
8 years ago
Jenkins 9697b1e5a2 Merge "Adds Image service v1 and v2 specification info in general" 9 years ago
Anne Gentle f46438ab1c Adds Image service v1 and v2 specification info in general
Goal is to maintain API specs in the specs repo for each project
and to eliminate the image-api repo.

Splits up original v2 API document into multiple files.

Change-Id: I7b6fbb1ee4a9a2e04395a7aa942d9ebdb011cc85
9 years ago
Doug Hellmann 0c75e7fb2a Use the current date for the copyright statement
Change-Id: Icef83b497f0c0bfad34054b88cf44717aefdb5fe
9 years ago
Doug Hellmann a7846e1b2c Remove templates from toctrees
We don't want the templates to show up in the RSS feed, so exclude them
from being converted to HTML and listed in the toctree.

Remove the now unused index.rst.

Change-Id: I28c02aff7a8d34ae6c5749c3cd8214a90ba593f3
9 years ago
Jenkins 219f8c62fa Merge "Stop using intersphinx" 9 years ago
Jenkins 6a0e71402a Merge "Add RSS feed" 9 years ago
Andreas Jaeger 6c33c58a39 Stop using intersphinx
Remove intersphinx from the docs build as it triggers network calls that
occasionally fail, and we don't really use intersphinx (links other
sphinx documents out on the internet)

This also removes the requirement for internet access during docs build.

This can cause docs jobs to fail if the project errors out on

Change-Id: I71e941e2a639641a662a163c682eb86d51de42fb
Related-Bug: #1368910
9 years ago
Doug Hellmann 39fa398313 Add RSS feed
Publish an RSS feed of the changes to the specs repository to make the
specs more discoverable.

Change-Id: Ib4f84efab8b3af3ddd47d38d63a91362612bd655
9 years ago