From ce09e37e8592a0d4e2cf6c65ad2c39a990093d35 Mon Sep 17 00:00:00 2001 From: Christian Poessinger Date: Wed, 6 Nov 2019 07:22:50 +0100 Subject: contributing: issues: add 80 character line breaks and links --- docs/contributing/issues_features.rst | 65 +++++++++++++++++++++-------------- 1 file changed, 40 insertions(+), 25 deletions(-) diff --git a/docs/contributing/issues_features.rst b/docs/contributing/issues_features.rst index d61d5b6c..02de2df6 100644 --- a/docs/contributing/issues_features.rst +++ b/docs/contributing/issues_features.rst @@ -7,51 +7,66 @@ Bug Report / Issue ------------------ Issues or bugs are found in any software project. VyOS is not an exception. -All issues should be reported to the developers. This lets the developers know what is not working properly. -Without this sort of feedback every developer will believe that everything is working correctly. +All issues should be reported to the developers. This lets the developers know +what is not working properly. Without this sort of feedback every developer +will believe that everything is working correctly. I have found a bug, what should I do? ************************************* -When you believe you have found a bug, it is always a good idea to verify the issue prior to opening a bug request. +When you believe you have found a bug, it is always a good idea to verify the +issue prior to opening a bug request. -* Consult the documentation to ensure that you have configured your system correctly. -* Get community support `slack `_ or `forum `_. +* Consult the documentation_ to ensure that you have configured your system + correctly +* Get community support via Slack_ or our Forum_ -Ensure that the problem is reproducible -*************************************** +Ensure the problem is reproducible +********************************** -When you are able to verify that it is actually a bug, spend some time to document how to reproduce the issue. -This documentation can be invaluable. When you wish to have a developer fix a bug that you found, helping them reproduce the issue benefits everyone. -Be sure to include information about the hardware you are using, commands that you were running, any other activities that you may have been doing at the time. -This additional information can be very useful. +When you are able to verify that it is actually a bug, spend some time to +document how to reproduce the issue. This documentation can be invaluable. + +When you wish to have a developer fix a bug that you found, helping them +reproduce the issue is beneficial to everyone. Be sure to include information +about the hardware you are using, commands that you were running, any other +activities that you may have been doing at the time. This additional +information can be very useful. * What were you attempting to achieve? * What was the configuration prior to the change? -* What commands did you use? +* What commands did you use? Use e.g. ``run show configuration commands`` Include output ************** -The output you get when you find a bug can provide lots of information. -If you get an error message on the screen, copy it exactly. Having the exact message can provide detail that the developers can use. -Like wise if you have any log messages that also are from the time of the issue, include those. -They may also contain information that is helpful for the development team. +The output you get when you find a bug can provide lots of information. If you +get an error message on the screen, copy it exactly. Having the exact message +can provide detail that the developers can use. Like wise if you have any log +messages that also are from the time of the issue, include those. They may +also contain information that is helpful for the development team. Report a Bug ************ -Create an account on the VyOS Phabricator. VyOS Phabricator is at https://phabricator.vyos.net. -To create a Bugreport use the quick link in the left side under the specific project. +Create an account on VyOS Phabricator_. Phabricator_ is located at +https://phabricator.vyos.net. To create a bug-report use the quick link in the +left side under the specific project. -* provide as much information as you can -* which version you use -* what is to do to reproduce the bug +* Provide as much information as you can +* Which version of VyOS are you using? ``run show version`` +* How can we reproduce this Bug? Feature Request --------------- -To send a Feature Request please search Phabricator if there is already a -feature request targeting your request. You can enhance it or if you don't find -one create a new one by use the quick link in the left side under the specific -project. \ No newline at end of file +You have an idea of how to make VyOS better or you are in need of a specific +feature which all users of VyOS would benefit from? To send a feature request +please search Phabricator_ if there is already a request pending. You can +enhance it or if you don't find one, create a new one by use the quick link in +the left side under the specific project. + +.. _documentation: https://vyos.redthedocs.io +.. _Slack: https://slack.vyos.io +.. _Forum: https://forum.vyos.io +.. _Phabricator: https://phabricator.vyos.net \ No newline at end of file -- cgit v1.2.3