Commit Graph

64 Commits

Author SHA1 Message Date
niuke 91f190cd6a remove unicode literal from code
Change-Id: I44e71499b52873a2350194081f352c12b871c592
2022-07-30 14:32:21 +08:00
Rico Lin 2745a5905f Change primary eamil for Rico Lin
Rico recently change his primary email
from rico.lin.guanyu@gmail.com
to ricolin@ricolky.com

Change-Id: Id26cfce9c14e30c1132234948cb03f99244ae55c
2021-03-05 17:41:16 +08:00
Andreas Jaeger befadaa1b0 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
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html

Change-Id: I30bdb1bf76a12e9562ab461b2701a36f34e770fe
2020-06-03 21:01:11 +02:00
Andreas Jaeger 33b57f352a Small cleanups
The default for install_command is good, no need to add our own version
in tox.ini. Remove it.

Remove git commands from conf.py, current openstackdocstheme handles
this itself.

Fix some missed api-wg -> api-sig renames in conf.py.

Change-Id: I806e804a5852e081f0cb8c1b43ffe13a119aba2c
2020-03-19 10:52:23 +00:00
Zuul 634f9a3ea4 Merge "Update to opendev" 2019-09-04 15:59:00 +00:00
Colleen Murphy 0d50eba6ad Update liaison for keystone
David Stanek isn't involved in keystone any more, so I am designating
myself as the liaison for keystone.

Change-Id: I2d396c9dad31a041ae86755c2ff3caf26f096bae
2019-05-16 09:14:26 -07:00
Le Hou 28289b4a00 Update to opendev
Change-Id: Icde84212c7008532a97a70fd9f8f768bae0e049b
2019-04-23 13:36:57 +08:00
Zuul 23f23dad06 Merge "Added Placement to the liaisons file" 2019-04-18 16:38:45 +00:00
EdLeafe efa0dcf2a4 Added Placement to the liaisons file
Added myself as the Placement liaison to the API-SIG. There was also an
empty duplicate section for Nova in the file, so I removed that.

Change-Id: I6701a06b8b0a70a2fe010cbd340ef5e6bc2520a7
2019-04-18 11:18:52 -05:00
Dmitry Tantsur 2ef2b12a82 Repair building guidelines
The recent yasfb is not compatible with ancient sphinx, just bump
both requirements, as well as replace deprecated oslosphinx with
openstackdocstheme (requirements shamelessly copied from ironic-specs).
While we're here, uncap pbr and bump it to 1.0.

Change-Id: Ia78499827a53f5ee0c7a8b0d9951a0e37dedc91b
2019-04-09 15:55:33 +00:00
Chris Dent e19e114c80 Add link to Building Protocols with HTTP
In a recent api-sig meeting it was decided that we should link
to this document as a good introduction and commentary on best
practices.

Change-Id: I662ed5c9c21a6eafb74cd1e224bf8c8953a556b6
2018-08-30 18:09:33 +01:00
Chris Dent b6d58a3f7f Explicitly link to the HTTP RFCs
In the opening we advise people to use the HTTP RFCs as the ultimate
authority but do not link to them. This change adds the links and
generalizes the warning to the entirety of the guidelines, not just
to non-JSON apis.

Change-Id: I40a59594a477d6802a16d8b0ca11020629eff292
2018-08-30 18:09:00 +01:00
Chris Dent d7dac9baf9 Update web frontpage to link to SIG not WG
Links to the wiki and git were out of date.

Also update .gitreview to reflect new repository name.

Change-Id: I950604740b7ef8d8ec0b1f97499bdc6e6648db0e
2018-08-06 13:00:44 +01:00
Ed Leafe 9fd03c71c7 Change API-WG to API-SIG
This updates as many references to 'API-WG', 'API Working Group', etc.,
to reflect the name change to the API-SIG.

Change-Id: I15ca0860c58bd7ba51f08dd39e551a774d7a060a
2017-10-12 18:07:33 +00:00
Ed Leafe f7a9b2e2f6 Remove the Nova liaison
The liaison for Nova, Matthew Gilliard, no longer works on OpenStack, so
this removes him as the Nova liaison. This entry will remain empty until
Nova selects a new liaison.

Change-Id: I6723410b8fc4edf426237bdfe584efa2d59d8255
2017-09-25 16:45:21 +00:00
Ed Leafe 200e122d30 Fix typo in liaisons.json
The previous update to this file switched the order of two rows, making
the text invalid JSON. This commit simply fixes that.

Change-Id: Ibb680c3f0f20e959c7171209980c53274df301b8
2017-09-07 16:50:11 +00:00
Michael McCune 6d3991fbfc add a document for guided review process
This change adds the first draft revision of the guided review process
document. It also slightly reorganizes the table of contents links for
guidance on the index page to make it clear which guidance is for API
issues and which are for working group process issues.

Change-Id: Ifd7c7dce7f61bc57555e3bd2abac2703c1c7b6a3
2017-08-03 15:29:06 -04:00
Jenkins 12bf769d63 Merge "Fix html_last_updated_fmt for Python3" 2017-06-29 16:24:17 +00:00
blue55 200981850a Fix html_last_updated_fmt 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: I76f9c05023a30f434d2b873254ef0f63b31d86bf
2017-06-19 11:24:00 +08:00
EdLeafe a4e5fcf4fd Update Liaison Information
Recent employment changes has resulted in several liasons no longer to
continue in that capacity. This patch updates with the current liaisons,
and also adds their emails, which will make contacting them about API-WG
issues simpler.

Change-Id: I22f37e462f2389b4ddc398d3d658c932d1b2e434
2017-06-16 17:00:15 +00:00
Akihiro Motoki c232e5bbee Change Neutron API-WG liaison
Change-Id: I0243d616f8b44926b9e6016a852dd4d10934f36d
2017-05-10 15:51:46 -04:00
ricolin 0e650c5a4d Change heat API-WG liaison
Change-Id: Icbd4c73f6ada63819fbf2f0133ea79bc1a8877b0
2017-05-04 21:05:07 +08:00
gecong1973 48a237ce31 Removes unnecessary utf-8 encoding
The conf.py file was added redundant utf-8 encoding by some editor.
we can delete it.

Change-Id: If2f15027e6f0f0dd8e9e649ff56af4324cf4f8db
2016-12-26 10:49:54 +08:00
Ruby Loo fb2eb9f3b9 Change ironic liaison from lucasagomes to vdrok
This changes the ironic liaison to the API Working Group,
from Lucas Gomes to Vladyslav Drok.

Change-Id: Ic84bc088b7c13a9b45ba9c70f60e7b175c8f850c
2016-11-10 14:43:09 -05:00
Michael McCune 57b9aa6a51 add a warning about json expectations
This change follows the discussion from a recent wg meeting[1] about
making a clear statement that the guidelines are assumed to be written
for JSON based payloads.

[1]:
http://eavesdrop.openstack.org/irclogs/%23openstack-meeting-3/%23openstack-meeting-3.2016-08-18.log.html#t2016-08-18T16:33:56

Change-Id: Iae6266c00062ad1693fe680b839dac49ff5518f7
Closes-Bug: #1614624
2016-09-22 12:18:39 -04:00
scottda 9e2e53cad2 Change Cinder api-wg liason
Alex Meade is stepping down. Scott DAngelo will replace him.

Change-Id: Id9472e94576e6248f1216b61b88a04b6b9cd9f1e
2016-08-30 13:40:50 -06:00
Chris Dent 76b96ff6c7 Get rid of the DRAFT warning at the top of guidelines
This makes it seem like the guidelines are not yet ready. They are
ready but they are also constantly evolving. We don't want people
to go away thinking we're not ready yet.

Change-Id: I41e5849ea9fe0e1ef39c485861dc6686e9df6f1d
2016-06-16 17:38:48 +01:00
Salvatore Orlando f31f6bd767 Remove salv-orlando from CP liaisons
The API-wg liaison task is unfortunately not compatible with
salv-orlando's schedule and its current involvement level in
Neutron. Therefore salv-orlando is removing himself from the
liaison list.

Neutron already has another liaison - Henryg.

Change-Id: Ief89d2035229f3ac880533e3dda32a0159a1d2f9
2016-06-03 07:48:49 -07:00
Renat Akhmerov fb2fe778e0 Add Renat Akhmerov as a liaison for Mistral
Change-Id: I7965217b82e4f00609e20afa10647ea2eb72fa14
2016-05-11 11:49:23 +07:00
Tim Hinrichs ed9f840593 Add Congress liaison
Change-Id: I14ee5c29aae94c6696fc0e712542c500e3ae29f2
2016-04-15 10:55:34 -07:00
Chris Dent 6cb5de91a3 Clarify who should be doing merging
Merging is done by the core who did the freezing.

Change-Id: I834f961f4e9fb9213dc8c3e010fef368e985a25d
2016-03-30 14:20:58 +00:00
Chris Dent c3a5ba0b08 Clarify the guideline proposal process
The steps in the proposal process were interleaved in a way
that made following them confusing. This change extracts the
definitions of terms from the actual process and simplifies the
process.

For the most part the spirit of the staged review process is
maintained but the steps required to reach out to the community
are clarified: Where there is consensus we involve just the CPLs.
Where there is not we reach out to the rest of community. I'm not
certain is the correct way to go. It's a compromise between keeping
things moving with minimal friction and including the broader
community as much as possible.

My hope is that this will help to clarify the term "frozen" and
when freezing is to be done.

This will probably require some iteration.

Change-Id: I416ff1dd35249674fb27f9dd7625786e52001556
2016-03-29 13:57:21 +01:00
Steve Martinelli 050fe3c707 replace dolphm with dstanek as keystone liaison
Change-Id: If5c654c4319dd2081c54413ce23b91cb7ee662c0
2016-01-19 15:23:59 -05:00
ting.wang 89b4fffb5d Replace deprecated library which used in python2.6
os.popen() is deprecated since python 2.6.
Resolved with use of subprocess module.

Change-Id: If95864f062853846fa14ac0ad392d97de8e7d359
2016-01-14 14:30:32 +08:00
Hua Wang 35bf769df5 Add liaison for Magnum project
Add Hua Wang as liaison for the Magnum project.

Change-Id: Ice00ee48526865ceba614ad6030a6414d321375e
2015-12-07 15:04:42 +08:00
Goutham Pacha Ravi b8edad28a8 Add liaison for Manila project
Add Goutham Pacha Ravi as liaison for the Manila project.

Change-Id: Ica61d6e7e73d6dae0e2d6d27e74d341436775a6c
2015-12-04 11:58:18 +05:30
Eli Qiao e8f80d95b9 Add liaison for Magnum project
Add Eli Qiao as liaison for the Magnum project.

Change-Id: Ie6657731206215d26d6a1e7bc92eb43d873b8b11
2015-12-03 09:25:00 +08:00
tengqm cd3e0af1fe Add liaison for senlin project
This patch adds Qiming Teng as liaison for the Senlin project.

Change-Id: I2403064284dae05e6674e5ca4e62447d3e10cec0
2015-11-23 01:20:51 -05:00
Everett Toews 6da669487c Invite people to connect by linking to the wiki
Change-Id: If423d033b5c80d637b97fb32156bae2f5d6be1cc
2015-11-12 16:22:25 -06:00
Everett Toews 4da096bb77 Remove the voting restriction
Based on feedback in this review [1] we want to remove the
restriction on voting on guidelines. That restriction was
a hold over from a Summit discussion when we didn't really
know how everything would work out. It's simply not necessary
at this point.

[1] https://review.openstack.org/#/c/213876/3/doc/source/process.rst

Change-Id: I842a365f3bc5d23b39039525d315194b3344ff04
2015-09-24 15:49:19 +00:00
Jenkins d2230489dc Merge "Process updates" 2015-08-26 15:42:07 +00:00
Everett Toews b77c68c6c4 Process updates
Update the process for core reviewers to add exactly one
CodeReview+2 to a review to consider it frozen. This is
preferable to freezing it with a Workflow-1 or CodeReview-2.

Document the use of the add-reviewers.py script.

Change-Id: I9c48bae7b69c5bbeffd2994148b6d02d2150cce5
2015-08-25 15:23:41 -05:00
Sergey Lukjanov 0c28916806 Sergey Lukjanov is not acting as a liaison
Change-Id: Ib1898d63efa2846e393acbdd970ba39edbd318d8
2015-08-18 03:35:27 +03:00
Everett Toews 15fa0916fb Add the Murano CPL
Change-Id: Ib22cf3c356759d638ce7239be266783093c772cc
2015-08-17 17:08:16 -05:00
Jenkins 478483cb79 Merge "Add reviewers to an API WG review" 2015-08-17 16:06:13 +00:00
Everett Toews 9e83fc0c10 Add reviewers to an API WG review
To make it easier to engage the liaisons, we have a tool that will
add all current liaisons to an API WG review.

Change-Id: I0c32aa407def04c8a81868ed8a682cb7888ff1ff
2015-07-06 12:08:02 -05:00
Jenkins bb3ed827b6 Merge "Use Code-Review to Freeze instead of Workflow" 2015-07-06 16:46:55 +00:00
Jenkins cdce62c8f5 Merge "Minor fixes to the process" 2015-07-06 16:07:00 +00:00
Jenkins ad8fdf3418 Merge "Change template to match our historic usage" 2015-07-06 16:06:45 +00:00
Everett Toews 5566e3b12f Use Code-Review to Freeze instead of Workflow
Let's use Code-Review -2 to Freeze instead of Workflow -1. The
semantics are better "Do not merge" vs "Work in progress" and
it's easier to filter the frozen guidelines vs those that are
actually a work in progress.

Change-Id: Ib030bcdfd5e90766a5a22ca84c86dc59ef30cdb5
2015-07-06 10:30:05 -05:00