Bug 468752

Summary:	proj/en/qa/autofailure.xml needs linguistic revision (bad grammar, wrong word choices, incomprehensible passages)
Product:	[OLD] Docs on www.gentoo.org	Reporter:	Roman Žilka <roman.zilka>
Component:	Other documents	Assignee:	Gentoo Quality Assurance Team <qa>
Status:	RESOLVED OBSOLETE
Severity:	minor	CC:	bkohler
Priority:	Normal
Version:	unspecified
Hardware:	All
OS:	Linux
URL:	http://www.gentoo.org/proj/en/qa/autofailure.xml
Whiteboard:
Package list:		Runtime testing required:	---

Description Roman Žilka 2013-05-06 12:24:23 UTC

http://www.gentoo.org/proj/en/qa/autofailure.xml contains some bad English. Very often it's mixing subjects in singular with verbs in plural or vice versa. Some words are nonsensical, but the overall meaning is usually easily understood. Comprehensibility is nil here, though: "older packages often does not use automake and libtool instead" (§1). Presumably, there are other such spots - I only read the first section.

By the way, the article is 5 years old. I'm not claiming it contains outdated info - I know little about autotools to judge. Just FYI.

Since it's mostly minor mistakes, I offer a correction of the full article. I can mark and leave untouched the spots whose intended meaning I don't know. I'm a non-native, CAE+ level speaker. If you're interested, let me know and provide the source file I should edit (or is it the xml I can fetch directly?).

Reproducible: Always

Comment 1 Ben Kohler gentoo-dev

2013-05-06 17:07:48 UTC

http://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo/xml/htdocs/proj/en/qa/

Comment 2 Michał Górny archtester

2016-06-16 12:16:36 UTC

GuideXML docs are no longer there.