Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 592592 - The Blockers section does not describe what a "softblocker" and "hardblocker" actually are
Summary: The Blockers section does not describe what a "softblocker" and "hardblocker"...
Status: RESOLVED FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Devmanual (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo Devmanual Team
URL: https://devmanual.gentoo.org/general-...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2016-08-31 13:14 UTC by Jeroen Roovers (RETIRED)
Modified: 2020-01-23 13:02 UTC (History)
0 users

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 Jeroen Roovers (RETIRED) gentoo-dev 2016-08-31 13:14:50 UTC
Just like "hardmask" gives no one any clue what it is who doesn't already know, a "softblocker" or "hardblocker" doesn't say what it is that these are supposed to do.

Things that don't help either:

The bit about "softblocker" is broken up by a code listing, but the remainder of that paragraph commits a style sin by then immediately changing the subject.

The remainder of that paragraph and the following paragraphs don't explain what a "hardblocker" is.

The remainder of the section describes blockers in general, so that text should come before the text about different types of blockers and not be tagged onto the end.
Comment 1 Ulrich Müller gentoo-dev 2020-01-23 13:02:48 UTC
AFAICS, the explanation in https://devmanual.gentoo.org/general-concepts/dependencies/index.html#blockers has been improved in the meantime.

Please reopen if you think that there's something still missing.