Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 254517 - avoid duplication in bugzilla-howto.xml and backtraces.xml
Summary: avoid duplication in bugzilla-howto.xml and backtraces.xml
Status: RESOLVED OBSOLETE
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Other documents (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-01-11 08:52 UTC by Peter Volkov (RETIRED)
Modified: 2013-07-22 12:09 UTC (History)
2 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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.