778fcbb064
For more information about this automatic import see: https://docs.openstack.org/i18n/latest/reviewing-translation-import.html Change-Id: I521db53a729fafc0ee8b6930d940128e3844dfbf
1470 lines
62 KiB
Plaintext
1470 lines
62 KiB
Plaintext
# Andi Chandler <andi@gowling.com>, 2018. #zanata
|
|
# Andi Chandler <andi@gowling.com>, 2019. #zanata
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: contributor-guide\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2019-02-11 21:21+0000\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"PO-Revision-Date: 2019-01-01 09:00+0000\n"
|
|
"Last-Translator: Andi Chandler <andi@gowling.com>\n"
|
|
"Language-Team: English (United Kingdom)\n"
|
|
"Language: en_GB\n"
|
|
"X-Generator: Zanata 4.3.3\n"
|
|
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
|
|
|
|
msgid "**+/- 1 & 0**"
|
|
msgstr "**+/- 1 & 0**"
|
|
|
|
msgid "**+/- 2 & +W**"
|
|
msgstr "**+/- 2 & +W**"
|
|
|
|
msgid "**Inline Comments**"
|
|
msgstr "**Inline Comments**"
|
|
|
|
msgid "**Reviewing Best Practices**"
|
|
msgstr "**Reviewing Best Practices**"
|
|
|
|
msgid ""
|
|
"+W: Approved. This patch will now be run through a final round of checks "
|
|
"before it is merged into the repository."
|
|
msgstr ""
|
|
"+W: Approved. This patch will now be run through a final round of checks "
|
|
"before it is merged into the repository."
|
|
|
|
msgid ""
|
|
":ref:`launchpad` is one of the task tracking tools that the community is "
|
|
"using."
|
|
msgstr ""
|
|
":ref:`launchpad` is one of the task tracking tools that the community is "
|
|
"using."
|
|
|
|
msgid ""
|
|
":ref:`storyboard` is a community-developed task tracking tool. The community-"
|
|
"wide adoption of the tool is in progress, you will find more and more "
|
|
"projects who migrated over to using StoryBoard already."
|
|
msgstr ""
|
|
":ref:`storyboard` is a community-developed task tracking tool. The community-"
|
|
"wide adoption of the tool is in progress, you will find more and more "
|
|
"projects who migrated over to using StoryBoard already."
|
|
|
|
msgid ""
|
|
"A ``clean.sh`` run does the steps for ``unstack.sh`` plus additional "
|
|
"cleaning:"
|
|
msgstr ""
|
|
"A ``clean.sh`` run does the steps for ``unstack.sh`` plus additional "
|
|
"cleaning:"
|
|
|
|
msgid ""
|
|
"A detailed description of the documentation tools and processes can be found "
|
|
"in the `OpenStack Documentation Contributor Guide <https://docs.openstack."
|
|
"org/doc-contrib-guide/index.html>`_."
|
|
msgstr ""
|
|
"A detailed description of the documentation tools and processes can be found "
|
|
"in the `OpenStack Documentation Contributor Guide <https://docs.openstack."
|
|
"org/doc-contrib-guide/index.html>`_."
|
|
|
|
msgid "A log of the stack.sh run is kept in ``/opt/stack/logs/stack.sh.log``."
|
|
msgstr "A log of the stack.sh run is kept in ``/opt/stack/logs/stack.sh.log``."
|
|
|
|
msgid ""
|
|
"A more complete reference of using systemd to interact with DevStack can be "
|
|
"found on the `Using Systemd in DevStack <https://docs.openstack.org/devstack/"
|
|
"latest/systemd.html>`_ page."
|
|
msgstr ""
|
|
"A more complete reference of using systemd to interact with DevStack can be "
|
|
"found on the `Using Systemd in DevStack <https://docs.openstack.org/devstack/"
|
|
"latest/systemd.html>`_ page."
|
|
|
|
msgid ""
|
|
"A patch chain is easy to handle if you keep in mind a few recommendations:"
|
|
msgstr ""
|
|
"A patch chain is easy to handle if you keep in mind a few recommendations:"
|
|
|
|
msgid "ADMIN_PASSWORD"
|
|
msgstr "ADMIN_PASSWORD"
|
|
|
|
msgid "Adding Reviewers"
|
|
msgstr "Adding Reviewers"
|
|
|
|
msgid ""
|
|
"After checking out the patch, you will be switched to a new branch "
|
|
"automatically, on which you can make your changes."
|
|
msgstr ""
|
|
"After checking out the patch, you will be switched to a new branch "
|
|
"automatically, on which you can make your changes."
|
|
|
|
msgid ""
|
|
"After proposing changes, you can track them at `Code Review <https://review."
|
|
"openstack.org>`_. After logging in, you will see a dashboard of \"Outgoing "
|
|
"reviews\" for changes you have proposed, \"Incoming reviews\" for changes "
|
|
"you are reviewing, and \"Recently closed\" changes for which you were either "
|
|
"a reviewer or owner."
|
|
msgstr ""
|
|
"After proposing changes, you can track them at `Code Review <https://review."
|
|
"openstack.org>`_. After logging in, you will see a dashboard of \"Outgoing "
|
|
"reviews\" for changes you have proposed, \"Incoming reviews\" for changes "
|
|
"you are reviewing, and \"Recently closed\" changes for which you were either "
|
|
"a reviewer or owner."
|
|
|
|
msgid ""
|
|
"After you've completed the Setup and Learn GIT section, the following "
|
|
"command configures the repository to know about Gerrit and installs the "
|
|
"``Change-Id`` commit hook. You only need to do this once per repository you "
|
|
"clone::"
|
|
msgstr ""
|
|
"After you've completed the Setup and Learn GIT section, the following "
|
|
"command configures the repository to know about Gerrit and installs the "
|
|
"``Change-Id`` commit hook. You only need to do this once per repository you "
|
|
"clone::"
|
|
|
|
msgid ""
|
|
"All the Sandbox repository and projects are identical to any other active "
|
|
"project's resources. You can find the same information and same "
|
|
"functionality as well to ensure you can practice everything you need to know "
|
|
"about the tool."
|
|
msgstr ""
|
|
"All the Sandbox repository and projects are identical to any other active "
|
|
"project's resources. You can find the same information and same "
|
|
"functionality as well to ensure you can practice everything you need to know "
|
|
"about the tool."
|
|
|
|
msgid "Allows you to:"
|
|
msgstr "Allows you to:"
|
|
|
|
msgid ""
|
|
"Always check the changes you made to each patch and be careful that you "
|
|
"applied the changes in the right one as patches still get merged "
|
|
"individually and there is no guarantee that the whole chain gets landed at "
|
|
"the same time."
|
|
msgstr ""
|
|
"Always check the changes you made to each patch and be careful that you "
|
|
"applied the changes in the right one as patches still get merged "
|
|
"individually and there is no guarantee that the whole chain gets landed at "
|
|
"the same time."
|
|
|
|
msgid ""
|
|
"Always handle a chain as one block of changes by rebasing the whole chain "
|
|
"and keep it up to date when you modify a patch to fix review comments or add "
|
|
"changes to it."
|
|
msgstr ""
|
|
"Always handle a chain as one block of changes by rebasing the whole chain "
|
|
"and keep it up to date when you modify a patch to fix review comments or add "
|
|
"changes to it."
|
|
|
|
msgid ""
|
|
"Always have a local branch for these changes to ensure that you don't mix it "
|
|
"together with changes related to another feature or bug fix."
|
|
msgstr ""
|
|
"Always have a local branch for these changes to ensure that you don't mix it "
|
|
"together with changes related to another feature or bug fix."
|
|
|
|
msgid ""
|
|
"Always try to extract as much as you can into other patches, like "
|
|
"documentation or logical parts of the functionality that do not depend on "
|
|
"common functions in a lower layer."
|
|
msgstr ""
|
|
"Always try to extract as much as you can into other patches, like "
|
|
"documentation or logical parts of the functionality that do not depend on "
|
|
"common functions in a lower layer."
|
|
|
|
msgid ""
|
|
"An important part of development is, obviously, being able to test changes "
|
|
"you develop and ensure that they function properly. In a complicated "
|
|
"ecosystem like OpenStack there is a need to also be able to verify the "
|
|
"interoperability of your code. You may make a change to Cinder but that "
|
|
"change can also impact the way that Nova interacts with Cinder's APIs."
|
|
msgstr ""
|
|
"An important part of development is, obviously, being able to test changes "
|
|
"you develop and ensure that they function properly. In a complicated "
|
|
"ecosystem like OpenStack there is a need to also be able to verify the "
|
|
"interoperability of your code. You may make a change to Cinder but that "
|
|
"change can also impact the way that Nova interacts with Cinder's APIs."
|
|
|
|
msgid ""
|
|
"Any temporary backing files needed to simulate a system are created in /opt/"
|
|
"stack/data"
|
|
msgstr ""
|
|
"Any temporary backing files needed to simulate a system are created in /opt/"
|
|
"stack/data"
|
|
|
|
msgid ""
|
|
"Assuming you have not added new files, you commit all your changes using::"
|
|
msgstr ""
|
|
"Assuming you have not added new files, you commit all your changes using::"
|
|
|
|
msgid ""
|
|
"At this point DevStack takes over preparing your node to function as an "
|
|
"OpenStack cloud. The following is done:"
|
|
msgstr ""
|
|
"At this point DevStack takes over preparing your node to function as an "
|
|
"OpenStack cloud. The following is done:"
|
|
|
|
msgid ""
|
|
"Beyond this you can also look into the functionality to find smaller "
|
|
"building blocks and make your changes smaller. For instance changes to an "
|
|
"object can be implemented first that you will use later when you implement "
|
|
"new API functionality."
|
|
msgstr ""
|
|
"Beyond this you can also look into the functionality to find smaller "
|
|
"building blocks and make your changes smaller. For instance changes to an "
|
|
"object can be implemented first that you will use later when you implement "
|
|
"new API functionality."
|
|
|
|
msgid ""
|
|
"By default, the core services for OpenStack are installed but users can "
|
|
"configure additional services to be deployed. All services are installed "
|
|
"from source. DevStack will pull the services from git master unless "
|
|
"configured to clone from a stable branch (i.e. stable/pike)."
|
|
msgstr ""
|
|
"By default, the core services for OpenStack are installed but users can "
|
|
"configure additional services to be deployed. All services are installed "
|
|
"from source. DevStack will pull the services from git master unless "
|
|
"configured to clone from a stable branch (i.e. stable/pike)."
|
|
|
|
msgid ""
|
|
"By grouping the changes per module you can also construct the chain or "
|
|
"dependencies by the hierarchy of the components and always keep the API "
|
|
"changes last as that will enable the new functionality and that change will "
|
|
"depend on everything else you needed to touch for your design."
|
|
msgstr ""
|
|
"By grouping the changes per module you can also construct the chain or "
|
|
"dependencies by the hierarchy of the components and always keep the API "
|
|
"changes last as that will enable the new functionality and that change will "
|
|
"depend on everything else you needed to touch for your design."
|
|
|
|
msgid ""
|
|
"Changes that are not related to any feature implementation or bug report can "
|
|
"be uploaded but are less welcomed by reviewers."
|
|
msgstr ""
|
|
"Changes that are not related to any feature implementation or bug report can "
|
|
"be uploaded but are less welcomed by reviewers."
|
|
|
|
msgid "Checking Out Others' Changes"
|
|
msgstr "Checking Out Others' Changes"
|
|
|
|
msgid "Cherry-picking"
|
|
msgstr "Cherry-picking"
|
|
|
|
msgid "Cleaning up iSCSI volumes"
|
|
msgstr "Cleaning up iSCSI volumes"
|
|
|
|
msgid "Clearing temporary LVM mounts"
|
|
msgstr "Clearing temporary LVM mounts"
|
|
|
|
msgid "Code & Documentation Contributor Guide"
|
|
msgstr "Code & Documentation Contributor Guide"
|
|
|
|
msgid "Code and Documentation Contributors"
|
|
msgstr "Code and Documentation Contributors"
|
|
|
|
msgid ""
|
|
"Communication is underrated, but crucial when it comes to participating in "
|
|
"an open source community. We have several tools that we use for online and "
|
|
"offline communication, which we encourage you to use."
|
|
msgstr ""
|
|
"Communication is underrated, but crucial when it comes to participating in "
|
|
"an open source community. We have several tools that we use for online and "
|
|
"offline communication, which we encourage you to use."
|
|
|
|
msgid ""
|
|
"Core reviewers have additional voting choices aside from the basic set. Like "
|
|
"the basic set, the numbers map to a simple system of meaning:"
|
|
msgstr ""
|
|
"Core reviewers have additional voting choices aside from the basic set. Like "
|
|
"the basic set, the numbers map to a simple system of meaning:"
|
|
|
|
msgid "DATABASE_PASSWORD"
|
|
msgstr "DATABASE_PASSWORD"
|
|
|
|
msgid "Database clean-up"
|
|
msgstr "Database clean-up"
|
|
|
|
msgid "Depends-On Tag"
|
|
msgstr "Depends-On Tag"
|
|
|
|
msgid "Deploying DevStack"
|
|
msgstr "Deploying DevStack"
|
|
|
|
msgid ""
|
|
"DevStack is a modular set of scripts that can be run to deploy a basic "
|
|
"OpenStack cloud for use as a demo or test environment. The scripts can be "
|
|
"run on a single node that is baremetal or a virtual machine. It can also be "
|
|
"configured to deploy to multiple nodes. DevStack deployment takes care of "
|
|
"tedious tasks like configuring the database and message queueing system, "
|
|
"making it possible for developers to quickly and easily deploy an OpenStack "
|
|
"cloud."
|
|
msgstr ""
|
|
"DevStack is a modular set of scripts that can be run to deploy a basic "
|
|
"OpenStack cloud for use as a demo or test environment. The scripts can be "
|
|
"run on a single node that is baremetal or a virtual machine. It can also be "
|
|
"configured to deploy to multiple nodes. DevStack deployment takes care of "
|
|
"tedious tasks like configuring the database and message queueing system, "
|
|
"making it possible for developers to quickly and easily deploy an OpenStack "
|
|
"cloud."
|
|
|
|
msgid ""
|
|
"DevStack uses the code in those directories to run the OpenStack services so "
|
|
"any change may be tested by making a code change in the project's directory "
|
|
"and then by restarting the project's service through systemd."
|
|
msgstr ""
|
|
"DevStack uses the code in those directories to run the OpenStack services so "
|
|
"any change may be tested by making a code change in the project's directory "
|
|
"and then by restarting the project's service through systemd."
|
|
|
|
msgid ""
|
|
"DevStack's full documentation can be found `here <https://docs.openstack.org/"
|
|
"devstack/latest>`_."
|
|
msgstr ""
|
|
"DevStack's full documentation can be found `here <https://docs.openstack.org/"
|
|
"devstack/latest>`_."
|
|
|
|
msgid ""
|
|
"Developers need an easy way to deploy an OpenStack cloud to do functional "
|
|
"and interoperability testing of changes. This is the purpose of DevStack."
|
|
msgstr ""
|
|
"Developers need an easy way to deploy an OpenStack cloud to do functional "
|
|
"and interoperability testing of changes. This is the purpose of DevStack."
|
|
|
|
msgid ""
|
|
"Each graph shows how many matches were found for that fingerprint over the "
|
|
"past 10 days. It also provides a link to both the launchpad page for the "
|
|
"bug, and the kibana dashboard for the underlying elastic-search query used "
|
|
"for the fingerprint."
|
|
msgstr ""
|
|
"Each graph shows how many matches were found for that fingerprint over the "
|
|
"past 10 days. It also provides a link to both the launchpad page for the "
|
|
"bug, and the Kibana dashboard for the underlying elastic-search query used "
|
|
"for the fingerprint."
|
|
|
|
msgid "Each project's database is created and populated"
|
|
msgstr "Each project's database is created and populated"
|
|
|
|
msgid ""
|
|
"Enhance the automatic testing the community does on every patch submitted to "
|
|
"gerrit"
|
|
msgstr ""
|
|
"Enhance the automatic testing the community does on every patch submitted to "
|
|
"Gerrit"
|
|
|
|
msgid ""
|
|
"Even if you have a chain of patches you still need to keep code changes and "
|
|
"related tests in one patch as you cannot guarantee that both land in time "
|
|
"for a release."
|
|
msgstr ""
|
|
"Even if you have a chain of patches you still need to keep code changes and "
|
|
"related tests in one patch as you cannot guarantee that both land in time "
|
|
"for a release."
|
|
|
|
msgid ""
|
|
"Following is a list of the commands that you need to know for your first "
|
|
"contribution:"
|
|
msgstr ""
|
|
"Following is a list of the commands that you need to know for your first "
|
|
"contribution:"
|
|
|
|
msgid ""
|
|
"Further down the file is the ``Using milestone-proposed branches`` section. "
|
|
"These are the variables that can be changed if you wish to clone a branch "
|
|
"other than master for one or more projects."
|
|
msgstr ""
|
|
"Further down the file is the ``Using milestone-proposed branches`` section. "
|
|
"These are the variables that can be changed if you wish to clone a branch "
|
|
"other than master for one or more projects."
|
|
|
|
msgid "General Information"
|
|
msgstr "General Information"
|
|
|
|
msgid "Gerrit Topics"
|
|
msgstr "Gerrit Topics"
|
|
|
|
msgid "Gerrit Web Editor"
|
|
msgstr "Gerrit Web Editor"
|
|
|
|
msgid "Gerrit allows you:"
|
|
msgstr "Gerrit allows you:"
|
|
|
|
msgid "Get an overview of the available projects for practice"
|
|
msgstr "Get an overview of the available projects for practice"
|
|
|
|
msgid "Get guidelines on how to use them"
|
|
msgstr "Get guidelines on how to use them"
|
|
|
|
msgid "Get reviews on your changes proposed to OpenStack repositories"
|
|
msgstr "Get reviews on your changes proposed to OpenStack repositories"
|
|
|
|
msgid "Getting and Configuring DevStack"
|
|
msgstr "Getting and Configuring DevStack"
|
|
|
|
msgid ""
|
|
"Git is a version control system that we use to track changes to our source "
|
|
"code and documentation."
|
|
msgstr ""
|
|
"Git is a version control system that we use to track changes to our source "
|
|
"code and documentation."
|
|
|
|
msgid ""
|
|
"Here is an example of what that process would look like. In this example a "
|
|
"change is made to Cinder's LVM driver:"
|
|
msgstr ""
|
|
"Here is an example of what that process would look like. In this example a "
|
|
"change is made to Cinder's LVM driver:"
|
|
|
|
msgid "How to Become a Patch Guru?"
|
|
msgstr "How to Become a Patch Guru?"
|
|
|
|
msgid "How to Handle Chains?"
|
|
msgstr "How to Handle Chains?"
|
|
|
|
msgid "How to Structure Your Changes?"
|
|
msgstr "How to Structure Your Changes?"
|
|
|
|
msgid "How to Use the Sandbox Projects"
|
|
msgstr "How to Use the Sandbox Projects"
|
|
|
|
msgid "Hypervisor clean-up"
|
|
msgstr "Hypervisor clean-up"
|
|
|
|
msgid ""
|
|
"If OpenStack was successfully deployed by DevStack you should be able to "
|
|
"point a web browser at the IP specified by ``HOST_IP`` in ``local.conf`` and "
|
|
"access Horizon."
|
|
msgstr ""
|
|
"If OpenStack was successfully deployed by DevStack you should be able to "
|
|
"point a web browser at the IP specified by ``HOST_IP`` in ``local.conf`` and "
|
|
"access Horizon."
|
|
|
|
msgid ""
|
|
"If successful, the Git response message will contain a URL you can use to "
|
|
"track your changes."
|
|
msgstr ""
|
|
"If successful, the Git response message will contain a URL you can use to "
|
|
"track your changes."
|
|
|
|
msgid ""
|
|
"If you can, test the code! In some cases you may not have access to the "
|
|
"specific hardware needed, but in general you should be able to test the "
|
|
"changes or look at the zuul build of the documentation so that you are doing "
|
|
"more than just looking at the code or documentation change."
|
|
msgstr ""
|
|
"If you can, test the code! In some cases you may not have access to the "
|
|
"specific hardware needed, but in general you should be able to test the "
|
|
"changes or look at the Zuul build of the documentation so that you are doing "
|
|
"more than just looking at the code or documentation change."
|
|
|
|
msgid ""
|
|
"If you have questions about the way something is phrased or done, or have "
|
|
"found some other issue the easiest way to let the author of the patch know "
|
|
"is to comment on that place inline. The inline comments are posted "
|
|
"collectively when you hit the 'Reply' button and add your vote on the "
|
|
"patchset."
|
|
msgstr ""
|
|
"If you have questions about the way something is phrased or done, or have "
|
|
"found some other issue the easiest way to let the author of the patch know "
|
|
"is to comment on that place inline. The inline comments are posted "
|
|
"collectively when you hit the 'Reply' button and add your vote on the "
|
|
"patchset."
|
|
|
|
msgid ""
|
|
"If you need to make further changes to the same review, you can commit them "
|
|
"using::"
|
|
msgstr ""
|
|
"If you need to make further changes to the same review, you can commit them "
|
|
"using::"
|
|
|
|
msgid ""
|
|
"If you only need to modify the top patch in the chain that can be done the "
|
|
"same way as you update individual patches."
|
|
msgstr ""
|
|
"If you only need to modify the top patch in the chain that can be done the "
|
|
"same way as you update individual patches."
|
|
|
|
msgid ""
|
|
"If you review a patch you are automatically added to the list of reviewers."
|
|
msgstr ""
|
|
"If you review a patch you are automatically added to the list of reviewers."
|
|
|
|
msgid ""
|
|
"If you're interested in more of the theory and history behind the project, "
|
|
"this talk from the Juno OpenStack Summit provides a good overview: `Elastic "
|
|
"Recheck - Tools for Finding Race Conditions in OpenStack <https://www."
|
|
"youtube.com/watch?v=Byo26Pioq1Y>`_"
|
|
msgstr ""
|
|
"If you're interested in more of the theory and history behind the project, "
|
|
"this talk from the Juno OpenStack Summit provides a good overview: `Elastic "
|
|
"Recheck - Tools for Finding Race Conditions in OpenStack <https://www."
|
|
"youtube.com/watch?v=Byo26Pioq1Y>`_"
|
|
|
|
msgid ""
|
|
"If your commit depends on a change which has been updated since you started "
|
|
"your work, and you need to get the latest patchset from that change, you can "
|
|
"cherry-pick your own changes on top of it:"
|
|
msgstr ""
|
|
"If your commit depends on a change which has been updated since you started "
|
|
"your work, and you need to get the latest patchset from that change, you can "
|
|
"cherry-pick your own changes on top of it:"
|
|
|
|
msgid ""
|
|
"If your patch gets a -1 it is not bad news, it just means you need to do a "
|
|
"little more work."
|
|
msgstr ""
|
|
"If your patch gets a -1 it is not bad news, it just means you need to do a "
|
|
"little more work."
|
|
|
|
msgid ""
|
|
"Improvement to either the code or documentation should be part of a larger "
|
|
"effort, like if you would like to fix typos in documentation then you should "
|
|
"do it for a larger block, like a whole guide. It is also preferred to report "
|
|
"a story with tasks for a work item like this that can be tracked later."
|
|
msgstr ""
|
|
"Improvement to either the code or documentation should be part of a larger "
|
|
"effort, like if you would like to fix typos in documentation then you should "
|
|
"do it for a larger block, like a whole guide. It is also preferred to report "
|
|
"a story with tasks for a work item like this that can be tracked later."
|
|
|
|
msgid ""
|
|
"In case of code refactoring work which makes the code more readable and "
|
|
"easier to maintain by restructuring methods and deleting unused code "
|
|
"snippets it is highly encouraged to consult with the project team and report "
|
|
"a story in StoryBoard first and then upload the relevant changes to Gerrit "
|
|
"for review."
|
|
msgstr ""
|
|
"In case of code refactoring work which makes the code more readable and "
|
|
"easier to maintain by restructuring methods and deleting unused code "
|
|
"snippets it is highly encouraged to consult with the project team and report "
|
|
"a story in StoryBoard first and then upload the relevant changes to Gerrit "
|
|
"for review."
|
|
|
|
msgid ""
|
|
"In case you use the 'Depends-On' tag you need to download all the changes "
|
|
"for a feature implementation or documentation change to test the feature or "
|
|
"build the documentation with all the changes applied. Git will not take care "
|
|
"of handling the dependencies automatically in this case."
|
|
msgstr ""
|
|
"In case you use the 'Depends-On' tag you need to download all the changes "
|
|
"for a feature implementation or documentation change to test the feature or "
|
|
"build the documentation with all the changes applied. Git will not take care "
|
|
"of handling the dependencies automatically in this case."
|
|
|
|
msgid ""
|
|
"In general, its best to avoid over using this gerrit capability because each "
|
|
"interaction with the patch- new patchsets, comments, CI system votes, etc.- "
|
|
"will send an email notification to every reviewer on the patch."
|
|
msgstr ""
|
|
"In general, its best to avoid over using this Gerrit capability because each "
|
|
"interaction with the patch- new patchsets, comments, CI system votes, etc.- "
|
|
"will send an email notification to every reviewer on the patch."
|
|
|
|
msgid ""
|
|
"In rare occasions when there is no good logical breakdown for a change and "
|
|
"your patch can grow to a thousand lines or more. In some cases it is "
|
|
"acceptable as you cannot extract the related test changes to another patch "
|
|
"for instance, but it's not highly recommended."
|
|
msgstr ""
|
|
"In rare occasions when there is no good logical breakdown for a change and "
|
|
"your patch can grow to a thousand lines or more. In some cases it is "
|
|
"acceptable as you cannot extract the related test changes to another patch "
|
|
"for instance, but it's not highly recommended."
|
|
|
|
msgid ""
|
|
"In some cases when you break down the required changes to smaller blocks you "
|
|
"cannot avoid having direct dependencies between them that prevents you from "
|
|
"having independent changes. You need to organize your changes in a chain to "
|
|
"maintain the dependencies which requires some additional care when you work "
|
|
"with these changes."
|
|
msgstr ""
|
|
"In some cases when you break down the required changes to smaller blocks you "
|
|
"cannot avoid having direct dependencies between them that prevents you from "
|
|
"having independent changes. You need to organize your changes in a chain to "
|
|
"maintain the dependencies which requires some additional care when you work "
|
|
"with these changes."
|
|
|
|
msgid ""
|
|
"In the case of complex feature implementation work when you need to "
|
|
"introduce changes to multiple modules of the same project or multiple "
|
|
"projects you need to be very careful with managing the dependencies."
|
|
msgstr ""
|
|
"In the case of complex feature implementation work when you need to "
|
|
"introduce changes to multiple modules of the same project or multiple "
|
|
"projects you need to be very careful with managing the dependencies."
|
|
|
|
msgid "Introduction"
|
|
msgstr "Introduction"
|
|
|
|
msgid ""
|
|
"It is a good practice to group changes by modules in a project, for instance "
|
|
"virt driver changes, compute manager and api changes in case of OpenStack "
|
|
"Compute."
|
|
msgstr ""
|
|
"It is a good practice to group changes by modules in a project, for instance "
|
|
"virt driver changes, compute manager and API changes in case of OpenStack "
|
|
"Compute."
|
|
|
|
msgid ""
|
|
"It is possible to edit your patch in the gerrit web interface and publish "
|
|
"the change without making the change locally. This is not generally advised "
|
|
"for larger code updates since it doesn't automatically update your local "
|
|
"working branch. In some cases, where the patch is basically ready to merge "
|
|
"aside from a small pep8 failure- whitespace at the end of line, needing to "
|
|
"wrap a line, etc- this gerrit feature can be convenient to make a quick edit "
|
|
"and publish the change without having to go through the entire 'git add', "
|
|
"'git commit --amend', 'git review' process."
|
|
msgstr ""
|
|
"It is possible to edit your patch in the Gerrit web interface and publish "
|
|
"the change without making the change locally. This is not generally advised "
|
|
"for larger code updates since it doesn't automatically update your local "
|
|
"working branch. In some cases, where the patch is basically ready to merge "
|
|
"aside from a small pep8 failure- whitespace at the end of line, needing to "
|
|
"wrap a line, etc- this Gerrit feature can be convenient to make a quick edit "
|
|
"and publish the change without having to go through the entire 'git add', "
|
|
"'git commit --amend', 'git review' process."
|
|
|
|
msgid ""
|
|
"It is recommended before proceeding further to set-up passwords and IP "
|
|
"addresses for the environment in which you are running DevStack. This is "
|
|
"done by configuring the ``local.conf`` file in DevStack."
|
|
msgstr ""
|
|
"It is recommended before proceeding further to set-up passwords and IP "
|
|
"addresses for the environment in which you are running DevStack. This is "
|
|
"done by configuring the ``local.conf`` file in DevStack."
|
|
|
|
msgid ""
|
|
"It is similar for code improvements. As the community is large and world-"
|
|
"wide we have coding guidelines, but the style of each individual can still "
|
|
"be very different. We don't enforce a particular coding style, therefore "
|
|
"changes related to fix that are less welcomed and are sources of very "
|
|
"opinionated arguments that should be avoided."
|
|
msgstr ""
|
|
"It is similar for code improvements. As the community is large and world-"
|
|
"wide we have coding guidelines, but the style of each individual can still "
|
|
"be very different. We don't enforce a particular coding style, therefore "
|
|
"changes related to fix that are less welcomed and are sources of very "
|
|
"opinionated arguments that should be avoided."
|
|
|
|
msgid ""
|
|
"Know how to structure a patch that is easier for community members to review"
|
|
msgstr ""
|
|
"Know how to structure a patch that is easier for community members to review"
|
|
|
|
msgid ""
|
|
"Know how to structure a patch that makes it easier to maintain throughout "
|
|
"the review process"
|
|
msgstr ""
|
|
"Know how to structure a patch that makes it easier to maintain throughout "
|
|
"the review process"
|
|
|
|
msgid "Launchpad is deprecated and will be superseeded by StoryBoard."
|
|
msgstr "Launchpad is deprecated and will be superseded by StoryBoard."
|
|
|
|
msgid ""
|
|
"Logs for the running services are also able to be viewed through systemd. To "
|
|
"display the logs for the Cinder Volume service the following command could "
|
|
"be used:"
|
|
msgstr ""
|
|
"Logs for the running services are also able to be viewed through systemd. To "
|
|
"display the logs for the Cinder Volume service the following command could "
|
|
"be used:"
|
|
|
|
msgid ""
|
|
"Longer patches require more time to review; wherever you can, keep the "
|
|
"length reasonable. And where you can't, you can help the reviewers by adding "
|
|
"code comments and writing a detailed commit message to describe the changes "
|
|
"you introduced in your patch."
|
|
msgstr ""
|
|
"Longer patches require more time to review; wherever you can, keep the "
|
|
"length reasonable. And where you can't, you can help the reviewers by adding "
|
|
"code comments and writing a detailed commit message to describe the changes "
|
|
"you introduced in your patch."
|
|
|
|
msgid "Make quick changes to your patches in the webui"
|
|
msgstr "Make quick changes to your patches in the WebUI"
|
|
|
|
msgid ""
|
|
"On some distributions you may need to also set the ``HOST_IP``. Whether this "
|
|
"is necessary will depend on what naming convention is used for network "
|
|
"interfaces in your operating system."
|
|
msgstr ""
|
|
"On some distributions you may need to also set the ``HOST_IP``. Whether this "
|
|
"is necessary will depend on what naming convention is used for network "
|
|
"interfaces in your operating system."
|
|
|
|
msgid ""
|
|
"Once testing and development of your code change is complete you will want "
|
|
"to push your code change to Gerrit for review. Since the projects in ``/opt/"
|
|
"stack`` are already synced to their respective git repository you can "
|
|
"configure `git review <https://docs.openstack.org/contributors/code-and-"
|
|
"documentation/using-gerrit.html>`_, commit your change and upload the "
|
|
"changes to Gerrit."
|
|
msgstr ""
|
|
"Once testing and development of your code change is complete you will want "
|
|
"to push your code change to Gerrit for review. Since the projects in ``/opt/"
|
|
"stack`` are already synced to their respective git repository you can "
|
|
"configure `git review <https://docs.openstack.org/contributors/code-and-"
|
|
"documentation/using-gerrit.html>`_, commit your change and upload the "
|
|
"changes to Gerrit."
|
|
|
|
msgid ""
|
|
"Once you have your ``local.conf`` file configured executing DevStack is "
|
|
"quite easy."
|
|
msgstr ""
|
|
"Once you have your ``local.conf`` file configured executing DevStack is "
|
|
"quite easy."
|
|
|
|
msgid ""
|
|
"Once you've constructed a query and checked in on elastic-search you should "
|
|
"create a yaml file in the queries directory of the elastic-recheck git repo. "
|
|
"The file name is the launchpad bug number for the bug and the contents are "
|
|
"the elastic-search query."
|
|
msgstr ""
|
|
"Once you've constructed a query and checked in on elastic-search you should "
|
|
"create a YAML file in the queries directory of the elastic-recheck git repo. "
|
|
"The file name is the launchpad bug number for the bug and the contents are "
|
|
"the elastic-search query."
|
|
|
|
msgid ""
|
|
"Once you've identified a message in the logs that can be used for "
|
|
"fingerprinting you need to turn that into an elastic-search query. You can "
|
|
"use any of the existing fingerprints as an example: `openstack-infra/elastic-"
|
|
"recheck <https://git.openstack.org/cgit/openstack-infra/elastic-recheck/tree/"
|
|
"queries>`_"
|
|
msgstr ""
|
|
"Once you've identified a message in the logs that can be used for "
|
|
"fingerprinting you need to turn that into an elastic-search query. You can "
|
|
"use any of the existing fingerprints as an example: `openstack-infra/elastic-"
|
|
"recheck <https://git.openstack.org/cgit/openstack-infra/elastic-recheck/tree/"
|
|
"queries>`_"
|
|
|
|
msgid ""
|
|
"Once your changes have been saved to local.conf you are ready to deploy an "
|
|
"OpenStack cloud with DevStack."
|
|
msgstr ""
|
|
"Once your changes have been saved to local.conf you are ready to deploy an "
|
|
"OpenStack cloud with DevStack."
|
|
|
|
msgid ""
|
|
"Only the person that voted the -2 can remove the vote and it will persist on "
|
|
"all new patchsets."
|
|
msgstr ""
|
|
"Only the person that voted the -2 can remove the vote and it will persist on "
|
|
"all new patchsets."
|
|
|
|
msgid "OpenStack Documentation Contributor Guide"
|
|
msgstr "OpenStack Documentation Contributor Guide"
|
|
|
|
msgid "Patch Chains"
|
|
msgstr "Patch Chains"
|
|
|
|
msgid "Patch Chains, Depends-On Tag and Gerrit Topics"
|
|
msgstr "Patch Chains, Depends-On Tag and Gerrit Topics"
|
|
|
|
msgid ""
|
|
"Project services are all registered with systemd. Each service is prefixed "
|
|
"with ``devstack@``. Therefore you may verify through systemd that the Cinder "
|
|
"Volume process is working with a command like:"
|
|
msgstr ""
|
|
"Project services are all registered with systemd. Each service is prefixed "
|
|
"with ``devstack@``. Therefore you may verify through systemd that the Cinder "
|
|
"Volume process is working with a command like:"
|
|
|
|
msgid "Pushing A Change"
|
|
msgstr "Pushing A Change"
|
|
|
|
msgid "RABBIT_PASSWORD"
|
|
msgstr "RABBIT_PASSWORD"
|
|
|
|
msgid ""
|
|
"Read the `Summary of Git commit message structure <https://wiki.openstack."
|
|
"org/wiki/GitCommitMessages?%22Summary%20of%20Git%20commit%20message"
|
|
"%20structure%22#Summary_of_Git_commit_message_structure>`_ for best "
|
|
"practices on writing the commit message. When you are ready to send your "
|
|
"changes for review use::"
|
|
msgstr ""
|
|
"Read the `Summary of Git commit message structure <https://wiki.openstack."
|
|
"org/wiki/GitCommitMessages?%22Summary%20of%20Git%20commit%20message"
|
|
"%20structure%22#Summary_of_Git_commit_message_structure>`_ for best "
|
|
"practices on writing the commit message. When you are ready to send your "
|
|
"changes for review use::"
|
|
|
|
msgid "Removal of .pyc files"
|
|
msgstr "Removal of .pyc files"
|
|
|
|
msgid "Removing configuration files for projects from /etc"
|
|
msgstr "Removing configuration files for projects from /etc"
|
|
|
|
msgid "Removing log files"
|
|
msgstr "Removing log files"
|
|
|
|
msgid "Report recurring bugs so that you don't need to manually 'recheck'"
|
|
msgstr "Report recurring bugs so that you don't need to manually 'recheck'"
|
|
|
|
msgid "Request reviews from specific community members"
|
|
msgstr "Request reviews from specific community members"
|
|
|
|
msgid "Required packages (like mysql and rabbitmq) are installed"
|
|
msgstr "Required packages (like MySQL and RabbitMQ) are installed"
|
|
|
|
msgid "Reviewing Changes"
|
|
msgstr "Reviewing Changes"
|
|
|
|
msgid ""
|
|
"Reviewing large patches is very inconvenient and time consuming therefore we "
|
|
"always suggest to break down your changes into smaller blocks."
|
|
msgstr ""
|
|
"Reviewing large patches is very inconvenient and time consuming therefore we "
|
|
"always suggest to break down your changes into smaller blocks."
|
|
|
|
msgid ""
|
|
"Running ``unstack.sh`` is the first thing to try in the case that a DevStack "
|
|
"run fails. If subsequent runs fail a more thorough removal of DevStack "
|
|
"components may be done with the following command:"
|
|
msgstr ""
|
|
"Running ``unstack.sh`` is the first thing to try in the case that a DevStack "
|
|
"run fails. If subsequent runs fail a more thorough removal of DevStack "
|
|
"components may be done with the following command:"
|
|
|
|
msgid "SandBox Git Repository"
|
|
msgstr "SandBox Git Repository"
|
|
|
|
msgid "SandBox Project on Launchpad"
|
|
msgstr "SandBox Project on Launchpad"
|
|
|
|
msgid "Sandbox Project on StoryBoard"
|
|
msgstr "Sandbox Project on StoryBoard"
|
|
|
|
msgid ""
|
|
"Since systemd accepts wildcards, the status of all services associated with "
|
|
"DevStack can be displayed with:"
|
|
msgstr ""
|
|
"Since systemd accepts wildcards, the status of all services associated with "
|
|
"DevStack can be displayed with:"
|
|
|
|
msgid ""
|
|
"Sometimes there might be people you need to weigh in on your patch because "
|
|
"they have a vested interest or are helping mentor you. The easiest way of "
|
|
"letting them know you have uploaded a new patch or patchset is to add them "
|
|
"as reviewers in the gerrit web-ui. You can look them up by name, gerrit "
|
|
"email address, ssh user name, or gerrit id."
|
|
msgstr ""
|
|
"Sometimes there might be people you need to weigh in on your patch because "
|
|
"they have a vested interest or are helping mentor you. The easiest way of "
|
|
"letting them know you have uploaded a new patch or patchset is to add them "
|
|
"as reviewers in the Gerrit WebUI. You can look them up by name, Gerrit email "
|
|
"address, ssh user name, or Gerrit id."
|
|
|
|
msgid "Stopping DevStack"
|
|
msgstr "Stopping DevStack"
|
|
|
|
msgid "Stopping the project services, mysql and rabbitmq"
|
|
msgstr "Stopping the project services, MySQL and RabbitMQ"
|
|
|
|
msgid "Testing Changes with DevStack"
|
|
msgstr "Testing Changes with DevStack"
|
|
|
|
msgid ""
|
|
"The 'Depends-On' tag is a marker on your changes and when used a patch "
|
|
"cannot be merged until all its dependencies are landed."
|
|
msgstr ""
|
|
"The 'Depends-On' tag is a marker on your changes and when used a patch "
|
|
"cannot be merged until all its dependencies are landed."
|
|
|
|
msgid "The OpenStack Services are registered and started"
|
|
msgstr "The OpenStack Services are registered and started"
|
|
|
|
msgid "The OpenStack projects are cloned into /opt/stack/"
|
|
msgstr "The OpenStack projects are cloned into /opt/stack/"
|
|
|
|
msgid "The Right Content"
|
|
msgstr "The Right Content"
|
|
|
|
msgid "The Right Size"
|
|
msgstr "The Right Size"
|
|
|
|
msgid ""
|
|
"The Sandbox repository and projects are maintained by community members with "
|
|
"occasional cleanup. Please help us with the housekeeping and clean up your "
|
|
"work, when you are finished with your practice and feel comfortable using "
|
|
"the tool."
|
|
msgstr ""
|
|
"The Sandbox repository and projects are maintained by community members with "
|
|
"occasional clean up. Please help us with the housekeeping and clean up your "
|
|
"work, when you are finished with your practice and feel comfortable using "
|
|
"the tool."
|
|
|
|
msgid ""
|
|
"The `OpenStack Documentation Contributor Guide <https://docs.openstack.org/"
|
|
"doc-contrib-guide/index.html>`_ describes how to contribute to OpenStack "
|
|
"documentation. It contains information on `writing <https://docs.openstack."
|
|
"org/doc-contrib-guide/writing-docs.html>`_, `building <https://docs."
|
|
"openstack.org/doc-contrib-guide/docs-builds.html>`_, and `reviewing <https://"
|
|
"docs.openstack.org/doc-contrib-guide/docs-review.html>`_ documents, as well "
|
|
"as best practices and `API documentation guidelines <https://docs.openstack."
|
|
"org/doc-contrib-guide/api-guides.html>`_."
|
|
msgstr ""
|
|
"The `OpenStack Documentation Contributor Guide <https://docs.openstack.org/"
|
|
"doc-contrib-guide/index.html>`_ describes how to contribute to OpenStack "
|
|
"documentation. It contains information on `writing <https://docs.openstack."
|
|
"org/doc-contrib-guide/writing-docs.html>`_, `building <https://docs."
|
|
"openstack.org/doc-contrib-guide/docs-builds.html>`_, and `reviewing <https://"
|
|
"docs.openstack.org/doc-contrib-guide/docs-review.html>`_ documents, as well "
|
|
"as best practices and `API documentation guidelines <https://docs.openstack."
|
|
"org/doc-contrib-guide/api-guides.html>`_."
|
|
|
|
msgid ""
|
|
"The ``admin`` password will be set to the value you put in your ``local."
|
|
"conf`` file for ``ADMIN_PASSWORD``"
|
|
msgstr ""
|
|
"The ``admin`` password will be set to the value you put in your ``local."
|
|
"conf`` file for ``ADMIN_PASSWORD``"
|
|
|
|
msgid ""
|
|
"The above command and subsequent command examples assume you are still in "
|
|
"the root directory of your DevStack clone."
|
|
msgstr ""
|
|
"The above command and subsequent command examples assume you are still in "
|
|
"the root directory of your DevStack clone."
|
|
|
|
msgid ""
|
|
"The basic set of values contributors have to vote with on a patch is: -1, 0, "
|
|
"or +1. These values correspond to a relatively simple system."
|
|
msgstr ""
|
|
"The basic set of values contributors have to vote with on a patch is: -1, 0, "
|
|
"or +1. These values correspond to a relatively simple system."
|
|
|
|
msgid "The change ID can be found on the web UI of Gerrit:"
|
|
msgstr "The change ID can be found on the web UI of Gerrit:"
|
|
|
|
msgid "The change ID is the same as in the previous case."
|
|
msgstr "The change ID is the same as in the previous case."
|
|
|
|
msgid ""
|
|
"The following command needs to be run as a user with sudo access and "
|
|
"NOPASSWD configured."
|
|
msgstr ""
|
|
"The following command needs to be run as a user with sudo access and "
|
|
"NOPASSWD configured."
|
|
|
|
msgid ""
|
|
"The heart of open source is the people who are participating in a community "
|
|
"and it is no different in case of OpenStack either."
|
|
msgstr ""
|
|
"The heart of open source is the people who are participating in a community "
|
|
"and it is no different in case of OpenStack either."
|
|
|
|
msgid ""
|
|
"The patch submitted is a duplicate or at odds with another patch submitted."
|
|
msgstr ""
|
|
"The patch submitted is a duplicate or at odds with another patch submitted."
|
|
|
|
msgid ""
|
|
"The tag can be applied to patches proposed for the same repository as well. "
|
|
"In that case the changes are separate enough to be kept independent which "
|
|
"means that if you need to fix changes from review comments you can do it on "
|
|
"a per patch basis. It is also true for rebasing each patch."
|
|
msgstr ""
|
|
"The tag can be applied to patches proposed for the same repository as well. "
|
|
"In that case the changes are separate enough to be kept independent which "
|
|
"means that if you need to fix changes from review comments you can do it on "
|
|
"a per patch basis. It is also true for rebasing each patch."
|
|
|
|
msgid ""
|
|
"The tools that we are using in the community can look complicated if you are "
|
|
"not familiar with them. To help you practice before you use them in action "
|
|
"we are providing sandbox environments for you where you can practice all the "
|
|
"steps we describe in this guide."
|
|
msgstr ""
|
|
"The tools that we are using in the community can look complicated if you are "
|
|
"not familiar with them. To help you practice before you use them in action "
|
|
"we are providing sandbox environments for you where you can practice all the "
|
|
"steps we describe in this guide."
|
|
|
|
msgid ""
|
|
"There are multiple options to choose from depending on the structure of your "
|
|
"design. You can either organize the changes in patch chains or you can use "
|
|
"the 'Depends-On' tag."
|
|
msgstr ""
|
|
"There are multiple options to choose from depending on the structure of your "
|
|
"design. You can either organize the changes in patch chains or you can use "
|
|
"the 'Depends-On' tag."
|
|
|
|
msgid ""
|
|
"There is a `Sandbox project <https://launchpad.net/openstack-dev-sandbox>`_ "
|
|
"available there which is created to track bugs and issues related to the "
|
|
"openstack-dev/sandbox repository."
|
|
msgstr ""
|
|
"There is a `Sandbox project <https://launchpad.net/openstack-dev-sandbox>`_ "
|
|
"available there which is created to track bugs and issues related to the "
|
|
"openstack-dev/sandbox repository."
|
|
|
|
msgid ""
|
|
"There is an issue with the approach taken in the patch and it needs to be "
|
|
"discussed with a larger group, likely in a meeting."
|
|
msgstr ""
|
|
"There is an issue with the approach taken in the patch and it needs to be "
|
|
"discussed with a larger group, likely in a meeting."
|
|
|
|
msgid ""
|
|
"This chapter will guide you through of all the tools and processes that we "
|
|
"are using to develop, test, maintain, and document the projects in OpenStack."
|
|
msgstr ""
|
|
"This chapter will guide you through of all the tools and processes that we "
|
|
"are using to develop, test, maintain, and document the projects in OpenStack."
|
|
|
|
msgid ""
|
|
"This command cleans up the OpenStack installation that was performed on the "
|
|
"node. This includes:"
|
|
msgstr ""
|
|
"This command cleans up the OpenStack installation that was performed on the "
|
|
"node. This includes:"
|
|
|
|
msgid ""
|
|
"This guide won't go into the details of tracing through the logs of a run "
|
|
"and finding a good fingerprint, since that's quite involved, dependent on "
|
|
"the job you're looking at, and already documented in a few places including:"
|
|
msgstr ""
|
|
"This guide won't go into the details of tracing through the logs of a run "
|
|
"and finding a good fingerprint, since that's quite involved, dependent on "
|
|
"the job you're looking at, and already documented in a few places including:"
|
|
|
|
msgid ""
|
|
"This is a good way to help tracking related changes, let that be a feature "
|
|
"implementation, bugfix or documentation work."
|
|
msgstr ""
|
|
"This is a good way to help tracking related changes, let that be a feature "
|
|
"implementation, bugfix or documentation work."
|
|
|
|
msgid ""
|
|
"This is a quick start version. For a more in depth description of how to "
|
|
"clone, create a patch and push the change, directions can be `found here "
|
|
"<https://docs.openstack.org/infra/manual/developers.html#starting-work-on-a-"
|
|
"new-project>`_"
|
|
msgstr ""
|
|
"This is a quick start version. For a more in depth description of how to "
|
|
"clone, create a patch and push the change, directions can be `found here "
|
|
"<https://docs.openstack.org/infra/manual/developers.html#starting-work-on-a-"
|
|
"new-project>`_"
|
|
|
|
msgid "This section allows you to:"
|
|
msgstr "This section allows you to:"
|
|
|
|
msgid ""
|
|
"This section assumes you have completed :doc:`../common/setup-gerrit` guide."
|
|
msgstr ""
|
|
"This section assumes you have completed :doc:`../common/setup-gerrit` guide."
|
|
|
|
msgid "This section assumes you have completed :doc:`/common/zuul-status`"
|
|
msgstr "This section assumes you have completed :doc:`/common/zuul-status`"
|
|
|
|
msgid ""
|
|
"This section will guide you through how to create patches that people will "
|
|
"want to review."
|
|
msgstr ""
|
|
"This section will guide you through how to create patches that people will "
|
|
"want to review."
|
|
|
|
msgid ""
|
|
"This will commit the changes under the same set of changes you issued "
|
|
"earlier. Notice that in order to send your latest version for review, you "
|
|
"will still need to call::"
|
|
msgstr ""
|
|
"This will commit the changes under the same set of changes you issued "
|
|
"earlier. Notice that in order to send your latest version for review, you "
|
|
"will still need to call::"
|
|
|
|
msgid ""
|
|
"To access the Gerrit Web Editor click on the icon that looks like a pencil "
|
|
"writing on paper next to the patch set number at the top of a Gerrit Code "
|
|
"Review page for a file."
|
|
msgstr ""
|
|
"To access the Gerrit Web Editor click on the icon that looks like a pencil "
|
|
"writing on paper next to the patch set number at the top of a Gerrit Code "
|
|
"Review page for a file."
|
|
|
|
msgid "To check the differences between your branch and the repository::"
|
|
msgstr "To check the differences between your branch and the repository::"
|
|
|
|
msgid "To check the files that have been updated in your branch::"
|
|
msgstr "To check the files that have been updated in your branch::"
|
|
|
|
msgid "To clone a copy of some repository::"
|
|
msgstr "To clone a copy of some repository::"
|
|
|
|
msgid ""
|
|
"To create your development branch (substitute branch_name for a name of your "
|
|
"choice). It's better to create a new branch for each patch than working from "
|
|
"master::"
|
|
msgstr ""
|
|
"To create your development branch (substitute branch_name for a name of your "
|
|
"choice). It's better to create a new branch for each patch than working from "
|
|
"master::"
|
|
|
|
msgid ""
|
|
"To download the full chain you need to download the top patch and Git will "
|
|
"automatically download all the dependent patches in the chain."
|
|
msgstr ""
|
|
"To download the full chain you need to download the top patch and Git will "
|
|
"automatically download all the dependent patches in the chain."
|
|
|
|
msgid ""
|
|
"To get DevStack you will need to clone it from the ``devstack`` repository "
|
|
"under ``openstack-dev``."
|
|
msgstr ""
|
|
"To get DevStack you will need to clone it from the ``devstack`` repository "
|
|
"under ``openstack-dev``."
|
|
|
|
msgid ""
|
|
"To modify a patch within a chain you will need to use interactive rebase:"
|
|
msgstr ""
|
|
"To modify a patch within a chain you will need to use interactive rebase:"
|
|
|
|
msgid ""
|
|
"To shutdown a DevStack instance running on a node the following command "
|
|
"should be used:"
|
|
msgstr ""
|
|
"To shutdown a DevStack instance running on a node the following command "
|
|
"should be used:"
|
|
|
|
msgid ""
|
|
"To simplify future interaction with your deployment you will want to set the "
|
|
"following variables:"
|
|
msgstr ""
|
|
"To simplify future interaction with your deployment you will want to set the "
|
|
"following variables:"
|
|
|
|
msgid "Tracking a new bug in elastic-recheck"
|
|
msgstr "Tracking a new bug in elastic-recheck"
|
|
|
|
msgid "Tracking your Changes"
|
|
msgstr "Tracking your Changes"
|
|
|
|
msgid ""
|
|
"Until you click 'Reply' and vote on the patch, any inline comments you've "
|
|
"made exist as drafts."
|
|
msgstr ""
|
|
"Until you click 'Reply' and vote on the patch, any inline comments you've "
|
|
"made exist as drafts."
|
|
|
|
msgid ""
|
|
"Using DevStack to develop and test changes is easy. Development can be done "
|
|
"in the project clones under ``/opt/stack/<project name>``. Since the "
|
|
"projects are clones of the project's git repository a branch can be made and "
|
|
"development can take place."
|
|
msgstr ""
|
|
"Using DevStack to develop and test changes is easy. Development can be done "
|
|
"in the project clones under ``/opt/stack/<project name>``. Since the "
|
|
"projects are clones of the project's git repository a branch can be made and "
|
|
"development can take place."
|
|
|
|
msgid "Using Elastic Recheck"
|
|
msgstr "Using Elastic Recheck"
|
|
|
|
msgid "Using Gerrit"
|
|
msgstr "Using Gerrit"
|
|
|
|
msgid "Verifying Your DevStack Deployment"
|
|
msgstr "Verifying Your DevStack Deployment"
|
|
|
|
msgid ""
|
|
"We do not differentiate between the different types of contributions such as "
|
|
"code or documentation therefore you will find guidance in this chapter for "
|
|
"all types."
|
|
msgstr ""
|
|
"We do not differentiate between the different types of contributions such as "
|
|
"code or documentation therefore you will find guidance in this chapter for "
|
|
"all types."
|
|
|
|
msgid "What is DevStack"
|
|
msgstr "What is DevStack"
|
|
|
|
msgid "What is elastic-recheck"
|
|
msgstr "What is elastic-recheck"
|
|
|
|
msgid "What to do if a test job fails"
|
|
msgstr "What to do if a test job fails"
|
|
|
|
msgid ""
|
|
"When you are working on implementing a new feature or adding documentation "
|
|
"to an already existing one it is easy to get carried away by the work itself "
|
|
"and forget about the unwritten rules of constructing your changes."
|
|
msgstr ""
|
|
"When you are working on implementing a new feature or adding documentation "
|
|
"to an already existing one it is easy to get carried away by the work itself "
|
|
"and forget about the unwritten rules of constructing your changes."
|
|
|
|
msgid ""
|
|
"When you encounter a failure that's not being tracked by elastic-recheck and "
|
|
"you've looked through the logs to determine that it's not being caused by "
|
|
"the proposed change and is affecting other changes you can propose a new "
|
|
"elastic-recheck fingerprint."
|
|
msgstr ""
|
|
"When you encounter a failure that's not being tracked by elastic-recheck and "
|
|
"you've looked through the logs to determine that it's not being caused by "
|
|
"the proposed change and is affecting other changes you can propose a new "
|
|
"elastic-recheck fingerprint."
|
|
|
|
msgid ""
|
|
"When you have a chain Gerrit helps you by listing all the commit titles in "
|
|
"the 'Related Changes' column on the top right corner of the Gerrit UI. The "
|
|
"titles are also links which help you navigate between the changes to review "
|
|
"them when you upload a new version."
|
|
msgstr ""
|
|
"When you have a chain Gerrit helps you by listing all the commit titles in "
|
|
"the 'Related Changes' column on the top right corner of the Gerrit UI. The "
|
|
"titles are also links which help you navigate between the changes to review "
|
|
"them when you upload a new version."
|
|
|
|
msgid ""
|
|
"When you have changes in multiple project repositories you can mark "
|
|
"dependent patches with the 'Depends-On' tag. The tag will appear as a link "
|
|
"in the commit message which helps you and also the reviewers to track and "
|
|
"navigate between the dependencies of your changes."
|
|
msgstr ""
|
|
"When you have changes in multiple project repositories you can mark "
|
|
"dependent patches with the 'Depends-On' tag. The tag will appear as a link "
|
|
"in the commit message which helps you and also the reviewers to track and "
|
|
"navigate between the dependencies of your changes."
|
|
|
|
msgid ""
|
|
"When you submit a patch to gerrit and zuul returns the test results for the "
|
|
"jobs it ran, sometimes one of those tests fails. Most of the time this "
|
|
"indicates there is an issue with your proposed change and the tests are "
|
|
"catching it. Sometimes the test run might have tripped over an underlying "
|
|
"pre-existing bug in OpenStack. Additionally, some times the infrastructure "
|
|
"for running the tests might have had a failure. To figure this out you'll "
|
|
"always need to look at the logs from the failed job to understand what's "
|
|
"happening."
|
|
msgstr ""
|
|
"When you submit a patch to Gerrit and Zuul returns the test results for the "
|
|
"jobs it ran, sometimes one of those tests fails. Most of the time this "
|
|
"indicates there is an issue with your proposed change and the tests are "
|
|
"catching it. Sometimes the test run might have tripped over an underlying "
|
|
"pre-existing bug in OpenStack. Additionally, some times the infrastructure "
|
|
"for running the tests might have had a failure. To figure this out you'll "
|
|
"always need to look at the logs from the failed job to understand what's "
|
|
"happening."
|
|
|
|
msgid ""
|
|
"When you upload changes in a chain only the patches that got updated will be "
|
|
"uploaded. This also means that the review scores on lower patches in the "
|
|
"chain will be untouched."
|
|
msgstr ""
|
|
"When you upload changes in a chain only the patches that got updated will be "
|
|
"uploaded. This also means that the review scores on lower patches in the "
|
|
"chain will be untouched."
|
|
|
|
msgid ""
|
|
"When your work item grows above a particular size and you need to upload "
|
|
"multiple patches it is crucial to structure it well in case of both patch "
|
|
"chains and independent changes."
|
|
msgstr ""
|
|
"When your work item grows above a particular size and you need to upload "
|
|
"multiple patches it is crucial to structure it well in case of both patch "
|
|
"chains and independent changes."
|
|
|
|
msgid ""
|
|
"While there is no magic number try to **keep the size of your changes as "
|
|
"small as possible**, but under a few hundreds of lines changed total. "
|
|
"Patches that are test heavy with little code change require as much effort "
|
|
"as code heavy changes."
|
|
msgstr ""
|
|
"While there is no magic number try to **keep the size of your changes as "
|
|
"small as possible**, but under a few hundreds of lines changed total. "
|
|
"Patches that are test heavy with little code change require as much effort "
|
|
"as code heavy changes."
|
|
|
|
msgid ""
|
|
"You can find a `Sandbox <https://storyboard-dev.openstack.org/#!/"
|
|
"project/2>`_ project in the tool that provides all the functionalities to "
|
|
"you as any of the other active projects."
|
|
msgstr ""
|
|
"You can find a `Sandbox <https://storyboard-dev.openstack.org/#!/"
|
|
"project/2>`_ project in the tool that provides all the functionalities to "
|
|
"you as any of the other active projects."
|
|
|
|
msgid ""
|
|
"You can find a `sandbox Git repository <https://git.openstack.org/cgit/"
|
|
"openstack-dev/sandbox>`_ where you can practice the Git commands before you "
|
|
"put together a patch to resolve a bug or implement a new functionality."
|
|
msgstr ""
|
|
"You can find a `sandbox Git repository <https://git.openstack.org/cgit/"
|
|
"openstack-dev/sandbox>`_ where you can practice the Git commands before you "
|
|
"put together a patch to resolve a bug or implement a new functionality."
|
|
|
|
msgid "You can find instructions on how to use Git in the :ref:`git` section."
|
|
msgstr "You can find instructions on how to use Git in the :ref:`git` section."
|
|
|
|
msgid ""
|
|
"You can find the same respositories using the search function here: "
|
|
"`OpenStack git repository browser <https://git.openstack.org/cgit>`_"
|
|
msgstr ""
|
|
"You can find the same repositories using the search function here: "
|
|
"`OpenStack git repository browser <https://git.openstack.org/cgit>`_"
|
|
|
|
msgid "You can find these pages at:"
|
|
msgstr "You can find these pages at:"
|
|
|
|
msgid ""
|
|
"You can see the current status of the bugs being tracked by elastic recheck "
|
|
"at: `Elastic Recheck <http://status.openstack.org/elastic-recheck/index."
|
|
"html>`_"
|
|
msgstr ""
|
|
"You can see the current status of the bugs being tracked by elastic recheck "
|
|
"at: `Elastic Recheck <http://status.openstack.org/elastic-recheck/index."
|
|
"html>`_"
|
|
|
|
msgid ""
|
|
"You can upload your changes to the sandbox repository and review it on "
|
|
"Gerrit as it is described in the :ref:`gerrit` section."
|
|
msgstr ""
|
|
"You can upload your changes to the sandbox repository and review it on "
|
|
"Gerrit as it is described in the :ref:`gerrit` section."
|
|
|
|
msgid ""
|
|
"You get permissions to perform all the operations in the Sandbox project for "
|
|
"the sake of practice. When you join a project as a contributor you will have "
|
|
"limited access to the functionalities as there are actions only core "
|
|
"reviewers can perform. You can find information about these in the "
|
|
"respective sections of the Contributor Guide."
|
|
msgstr ""
|
|
"You get permissions to perform all the operations in the Sandbox project for "
|
|
"the sake of practice. When you join a project as a contributor you will have "
|
|
"limited access to the functionalities as there are actions only core "
|
|
"reviewers can perform. You can find information about these in the "
|
|
"respective sections of the Contributor Guide."
|
|
|
|
msgid ""
|
|
"You have the option to specify a topic for your changes when you upload them "
|
|
"for review. While Gerrit topics will not add dependency to your patches you "
|
|
"can apply a search based on the topic that will show you all the relevant "
|
|
"changes in all the projects where there are patches with the same topic. "
|
|
"Gerrit will also show them to you in the 'Same Topic' column on the top "
|
|
"right corner of the page of a review."
|
|
msgstr ""
|
|
"You have the option to specify a topic for your changes when you upload them "
|
|
"for review. While Gerrit topics will not add dependency to your patches you "
|
|
"can apply a search based on the topic that will show you all the relevant "
|
|
"changes in all the projects where there are patches with the same topic. "
|
|
"Gerrit will also show them to you in the 'Same Topic' column on the top "
|
|
"right corner of the page of a review."
|
|
|
|
msgid ""
|
|
"You should also check any elastic search queries using kibana at: `Logstash "
|
|
"Search <http://logstash.openstack.org/>`_"
|
|
msgstr ""
|
|
"You should also check any elastic search queries using Kibana at: `Logstash "
|
|
"Search <http://logstash.openstack.org/>`_"
|
|
|
|
msgid ""
|
|
"`+1`_: Looks good to me, but someone else must approve. This does not mean "
|
|
"that there is nothing to comment on, just that there aren't any issues that "
|
|
"would block the merging of the patch. You can still make comments on "
|
|
"nitpicky things the patch owner can address if others find issues with the "
|
|
"patch. These comments might also be something to address in a followup patch "
|
|
"as opposed to another patchset."
|
|
msgstr ""
|
|
"`+1`_: Looks good to me, but someone else must approve. This does not mean "
|
|
"that there is nothing to comment on, just that there aren't any issues that "
|
|
"would block the merging of the patch. You can still make comments on "
|
|
"nitpicky things the patch owner can address if others find issues with the "
|
|
"patch. These comments might also be something to address in a follow up "
|
|
"patch as opposed to another patchset."
|
|
|
|
msgid ""
|
|
"`+2`_: Looks good to me (core reviewer). Depending on the project team and "
|
|
"repository, merging a patch will require at least one +2 vote if not two +2 "
|
|
"votes."
|
|
msgstr ""
|
|
"`+2`_: Looks good to me (core reviewer). Depending on the project team and "
|
|
"repository, merging a patch will require at least one +2 vote if not two +2 "
|
|
"votes."
|
|
|
|
msgid ""
|
|
"`-1`_: This patch needs further work before it can be merged. A -1 is "
|
|
"usually given when the reviewer sees some issue that needs to be fixed "
|
|
"before the patch can be merged. The issues the author needs to address "
|
|
"would, ideally, have inline comments posted on them unless there is some "
|
|
"larger issue. If there is something wrong with the overall approach, you are "
|
|
"able to leave an overall comment with the vote to raise your concerns."
|
|
msgstr ""
|
|
"`-1`_: This patch needs further work before it can be merged. A -1 is "
|
|
"usually given when the reviewer sees some issue that needs to be fixed "
|
|
"before the patch can be merged. The issues the author needs to address "
|
|
"would, ideally, have inline comments posted on them unless there is some "
|
|
"larger issue. If there is something wrong with the overall approach, you are "
|
|
"able to leave an overall comment with the vote to raise your concerns."
|
|
|
|
msgid ""
|
|
"`-2`_: Do not merge. This score does not often appear and when it does, it's "
|
|
"for a good reason:"
|
|
msgstr ""
|
|
"`-2`_: Do not merge. This score does not often appear and when it does, it's "
|
|
"for a good reason:"
|
|
|
|
msgid ""
|
|
"`0`_: No score. This is the default score when replying to a patchset. "
|
|
"Generally it's kept as the vote when someone has a question about the "
|
|
"patchset or doesn't have a fully formed opinion of the patchset yet - it "
|
|
"requires more time, testing, or investigation."
|
|
msgstr ""
|
|
"`0`_: No score. This is the default score when replying to a patchset. "
|
|
"Generally it's kept as the vote when someone has a question about the "
|
|
"patchset or doesn't have a fully formed opinion of the patchset yet - it "
|
|
"requires more time, testing, or investigation."
|
|
|
|
msgid ""
|
|
"`Tales From the Gate: How Debugging the Gate Helps Your Enterprise <https://"
|
|
"www.openstack.org/videos/vancouver-2015/tales-from-the-gate-how-debugging-"
|
|
"the-gate-helps-your-enterprise>`_"
|
|
msgstr ""
|
|
"`Tales From the Gate: How Debugging the Gate Helps Your Enterprise <https://"
|
|
"www.openstack.org/videos/vancouver-2015/tales-from-the-gate-how-debugging-"
|
|
"the-gate-helps-your-enterprise>`_"
|
|
|
|
msgid ""
|
|
"`Unclassified failed integrated gate jobs <http://status.openstack.org/"
|
|
"elastic-recheck/data/integrated_gate.html>`_ and `Unclassified failed jobs "
|
|
"<http://status.openstack.org/elastic-recheck/data/others.html>`_"
|
|
msgstr ""
|
|
"`Unclassified failed integrated gate jobs <http://status.openstack.org/"
|
|
"elastic-recheck/data/integrated_gate.html>`_ and `Unclassified failed jobs "
|
|
"<http://status.openstack.org/elastic-recheck/data/others.html>`_"
|
|
|
|
msgid ""
|
|
"`elastic-recheck queries <https://docs.openstack.org/infra/elastic-recheck/"
|
|
"readme.html#queries>`_"
|
|
msgstr ""
|
|
"`elastic-recheck queries <https://docs.openstack.org/infra/elastic-recheck/"
|
|
"readme.html#queries>`_"
|
|
|
|
msgid "depending on which jobs you're interested in."
|
|
msgstr "depending on which jobs you're interested in."
|
|
|
|
msgid ""
|
|
"elastic-recheck also has a page to show how many failures were encountered "
|
|
"that do not have a matching fingerprint. Typically the more failures that go "
|
|
"uncategorized the more unstable the gate is (and OpenStack as a whole)."
|
|
msgstr ""
|
|
"elastic-recheck also has a page to show how many failures were encountered "
|
|
"that do not have a matching fingerprint. Typically the more failures that go "
|
|
"uncategorised the more unstable the gate is (and OpenStack as a whole)."
|
|
|
|
msgid ""
|
|
"elastic-recheck is a tool used to track failures in test jobs. It keeps a "
|
|
"repository of fingerprints for known bugs that are affecting jobs in the "
|
|
"gate. It is then used to both track the rates those bugs are being found and "
|
|
"also to leave comments in gerrit and in IRC when it has found a known bug "
|
|
"fingerprint in a failure."
|
|
msgstr ""
|
|
"elastic-recheck is a tool used to track failures in test jobs. It keeps a "
|
|
"repository of fingerprints for known bugs that are affecting jobs in the "
|
|
"gate. It is then used to both track the rates those bugs are being found and "
|
|
"also to leave comments in Gerrit and in IRC when it has found a known bug "
|
|
"fingerprint in a failure."
|
|
|
|
msgid "etc."
|
|
msgstr "etc."
|
|
|
|
msgid "mysql and rabbitmq are configured"
|
|
msgstr "MySQL and RabbitMQ are configured"
|