Beefy Boxes and Bandwidth Generously Provided by pair Networks
Pathologically Eclectic Rubbish Lister
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??

one reader's take: you have the makings of a very good regex article here...

my quibbles: the editorial matter (re strict, warnings, etc) before you get to regex issues might well be split off -- perhaps multiple splits, as others have suggested. Seems to me that the title would be annoyingly misleading, otherwise.

As for your use of English -- you have used some constructs that vary from the forms used by those whose first language is "American English" but almost none (see first list item below) of them obstruct understanding or present any serious obstacle to "ease of reading."

coupla' specifics: (updates, 20050328 and new language suggestions below (waaay! far down))

  1. Has been addressed: para 4: "lined out equally" might be more colloquially phrased "aligned vertically." (problem is that "lined out" is synonymous with "struck out.")
  2. Suggest you expand para 8 with some examples, explanations. Advising one to "RTFM" is sometimes all well and good, but in an article with a tutorial intent, it seems to me to verge on rudeness to the reader (and lest that be a mystery, because (1) it's a contraction for a phrase which uses a word offensive to some and (2, more important) TFM is extremely dense and sometimes -- depending on the reader's learning style -- difficult to absorb. You might consider offering links several choices of explanatory material including but not limited to Owl, Friedl, TFM and others (Yes, I'm one such and would love to find the "other" that sings to me.)
  3. repeated below"syntaxis" ??? Unfamiliar, not found in a quick dictionary check. Suspect you intend "syntax."
  4. Suggested addition: brief discussion of the ephemeral character of $1 ... (ie, reset issues) $1 is mentioned in para 6.

Hope this is some help. Please, drive on with your good work! ++


In reply to Re: [Try-out] Regexp do's and don'ts by ww
in thread Regexp do's and don'ts by muba

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":



  • Are you posting in the right place? Check out Where do I post X? to know for sure.
  • Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
    <code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
  • Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
  • Want more info? How to link or How to display code and escape characters are good places to start.
Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others exploiting the Monastery: (4)
As of 2024-04-16 05:20 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found