You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pdfbox.apache.org by ms...@apache.org on 2016/08/03 19:25:05 UTC
pdfbox-docs git commit: PDFBOX-3330: remove duplicate text;
clarify wording around JIRA and issue tracker
Repository: pdfbox-docs
Updated Branches:
refs/heads/master da3aa6c04 -> d16758595
PDFBOX-3330: remove duplicate text; clarify wording around JIRA and issue tracker
Project: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/commit/d1675859
Tree: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/tree/d1675859
Diff: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/diff/d1675859
Branch: refs/heads/master
Commit: d167585957b09bac2f70a6d030ccc68bea3fc42b
Parents: da3aa6c
Author: Maruan Sahyoun <sa...@fileaffairs.de>
Authored: Wed Aug 3 21:24:57 2016 +0200
Committer: Maruan Sahyoun <sa...@fileaffairs.de>
Committed: Wed Aug 3 21:24:57 2016 +0200
----------------------------------------------------------------------
content/support.md | 18 ++++++++----------
1 file changed, 8 insertions(+), 10 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/d1675859/content/support.md
----------------------------------------------------------------------
diff --git a/content/support.md b/content/support.md
index 89bfa98..2ddf4b1 100644
--- a/content/support.md
+++ b/content/support.md
@@ -33,12 +33,12 @@ And there are additonal resources available on sites such as [Stack Overflow](ht
## Filing a bug report or enhancement request
-<p class="alert alert-info">Please refrain from immediately opening a ticket in the issue tracker unless
-you are really certain it's a problem in the PDFBox software. Try using the Mailing Lists
+<p class="alert alert-info">Please refrain from immediately opening a ticket in the JIRA issue tracker unless
+you are really certain it's a problem in the PDFBox software. Try using the Mailing Lists
before.</p>
-If you are sure you have found a bug the please report the problem in our
-[Issue Tracker](https://issues.apache.org/jira/browse/PDFBOX).
+If you are sure you have found a bug the please report the problem in our
+[JIRA Issue Tracker](https://issues.apache.org/jira/browse/PDFBOX).
**Before you submit a bug there are several things you can try first**
@@ -46,25 +46,23 @@ If you are sure you have found a bug the please report the problem in our
- for issues with text extraction try if Adobe Reader can extract the text
- try the latest SNAPSHOT to see if it's fixed in the pre-release
- search the mailing list to see if has been discussed before
- - check the issue tracker to see if the issue has already been reported
+ - check the JIRA issue tracker to see if the issue has already been reported
**To help us resolving a bug quicker**
- - attach the PDF that makes trouble by using "More", "Attach files" in the issue tracker
+ - attach the PDF that makes trouble by using "More", "Attach files" in the JIRA issue tracker
- if your file is too large, upload it to a sharehoster, or use the PDFSplit application to isolate the troublesome page
- mention the PDFBox version you are using.
- attach the shortest possible code that reproduces the problem. Insert java code between {code}...{code}. Or try to reproduce the problem with the command line applications.
- mention what you were doing, what was the expected behaviour, and what happened instead
- provide a stack trace of an exception if there is one
- - try using the non-sequential parser (loadNonSeq() instead of load(), and "-nonSeq" with the command line applications)
- - search JIRA if your problem has been mentioned before.
- Be patient: all the people here are unpaid volunteers who work for you in their free time
**And please DON'T**
- upload files to a hoster that requires registration to read the file.
- - create an issue in JIRA and then go on vacation so you won't repond to our questions / suggestions.
- - ask "how to" questions in JIRA. Ask such questions on the mailing lists, on stackoverflow.com, and look at the sample and the test code in the sources.
+ - create an issue in the JIRA issue tracker and then go on vacation so you won't repond to our questions / suggestions.
+ - ask "how to" questions in JIRA issue tracker. Ask such questions on the mailing lists, on stackoverflow.com, and look at the sample and the test code in the sources.
- attach PDF files with confidential and/or personal data (name, DoB, bank data, health data, SSN) without getting permission from the client and/or the people mentioned on the PDF
- create issues about obsolete PDFBox versions