Bug 254517

Summary:	avoid duplication in bugzilla-howto.xml and backtraces.xml
Product:	[OLD] Docs on www.gentoo.org	Reporter:	Peter Volkov (RETIRED) <pva>
Component:	Other documents	Assignee:	Docs Team <docs-team>
Status:	RESOLVED OBSOLETE
Severity:	normal	CC:	gentoo.integer, qa
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description Peter Volkov (RETIRED) gentoo-dev

2009-01-11 08:52:27 UTC

We have to documents:
http://www.gentoo.org/doc/en/bugzilla-howto.xml
http://www.gentoo.org/proj/en/qa/backtraces.xml

Please, merge ideas and descriptions from bugzilla-howto into backtraces guide and leave only short commands (without lot's of explanations) in bugzilla-howto. Also add link on detailed instructions into bugzilla-howto (from bugzilla-howto on backtraces).

The reasoning is that maintaining two documents with similar ideas is not very effective and in reality bugzilla-howto became more outdated and don't document splitdebug feature. On the other hand having deep knowledge and understanding about stripping and other things is not required to gather backtrace and report useful bug report. So this change aims to make bugzilla-howto more terse and short, while keeping links for those who want to know more.

And yes, I see that backtraces.xml is not in documentation domain, but probably it's good chance to incorporate it there.

Thank you in advance for your time.

Comment 1 Sven Vermeulen (RETIRED) gentoo-dev

2013-07-22 12:09:39 UTC

I have migrated the document to the Gentoo wiki (https://wiki.gentoo.org/wiki/Bugzilla_HOWTO) so mergers can be done there.