in reply to RFC: Monastery Markup Introduction

Nitpick: "Deprecated" should be replaced with "strongly discouraged" so that it falls in line with what the Perl Monks Approved HTML tags document actually says. Nowhere in that FAQ does it say that any tags are deprecated and I do not think this FAQlet should contradict the more authoritative document.

Replies are listed 'Best First'.
Re^2: RFC: Monastery Markup Introduction
by ww (Archbishop) on Mar 10, 2008 at 21:45 UTC

    Thanks for comment (++) because the more precision we can manage in the end product (within the limits of the brevity espoused by other respondents), the better that product will serve us.

    I think your "nitpick" is well taken because, as I understand it, the most common IT useage is in the sense Don't use this, because the "command" or "statement" may become obsolete.

    I'm torn, however, about adopting that suggestion and hope others will weigh in because "discouraged" is the first (3rd overall, with the first two labeled "archaic") current definition for "deprecate" in Merriam-Webster's book while Cambridge ("Advanced Learners Dictionary") cites "disapprove" first.

    :-) Aside: Personally, I'm much taken by the second archaic sense:

    b: to seek to avert
    <deprecate the wrath…of the Roman people — Tobias Smollett>

    ...if we just s/Roman people/Perl Monks/

    And re the consistency argument, we're already inconsistent: Perl Monks Approved HTML tags does indeed discourage or strongly discourage some markup, including <br> while Writeup Formatting Tips specifically encourages it:
    "Use a <br> or a <br/> to get a line-break...."

      Well, I'm not torn up about anything! That's because "deprecated" in computer jargon means that that feature (or program) is going to be removed in a future version.

      I think the intent is that using <br> in place of <p> is discouraged so I do not see any inconsistency in those two documents since both suggest using <p> tags for paragraphs.

      Nice try but you will have to do better than that!! :-)