Beefy Boxes and Bandwidth Generously Provided by pair Networks
laziness, impatience, and hubris
 
PerlMonks  

jakobi's scratchpad

by jakobi (Pilgrim)
on Sep 18, 2009 at 18:52 UTC ( [id://796181]=scratchpad: print w/replies, xml ) Need Help??


for this section also check the thread q: is there a new user thread to add comments to?.
TODO: clean up this section together with the FAQlets and the raw bookmarks; maybe forkoff the newbie stuff to a separate page (or thread???)

old stuff follows, raw bookmarks still to sort into faqlets at EOF

jdporter -- re: tutorial quest - some more small fries

> Debugging and Optimization is just a list of nodes...

That adds a bit to the challenge. What I still see would be these. Do you see anything sane and HELPFUL in the list below?

Something that would make Debugging and Optimization better for new monks? (IMHO mere replication or splitting of help or listing too many proper tutorials would make it worse instead for perl beginners. Make them drown in help isn't help, not even with super search, even if it could be restricted to search-only-the-contents-of-the-links-this-list-points-to)

  • If manually adding to the list is possible, adding associated RFC or discussion threads that spawned the tutorial (add still should collect feedback for it) after the tutorial should be possible (nodes 745150 and 744845 below 745674).

  • If it is sorted, mangling flag or titles might help. If e.g. the eclipse node I extracted from one thread gets sorted to a strange positon, things get a bit more funny.

  • If this list-of-nodes type can also a) list the node type in addition to the link (like SuperSearch does; so this link it the tutorial, that is it's the discussion and comments for the tutorial) or b) offer to include header or footer information, e.g. the footnote below could be added or a not-really suitable location for something
  • wrapping with proxy nodes might help: automatically forward (server side or META) / refresh / 302 (both meta; or whatever the http redirect code was) or least contain just the link to the new node(s) in a node of type list-of-nodes. Or 1:N links, which is what Debugging and Optimization currently is. Replacing each current link with another list-of-nodes comes to mind, that contains first the tutorial, then the tutorial's meta nodes (that is RFC, ...). A bit on the ugly side.

Doing it altogether differently

  • another angle, add all tutorial spawning discussions and RFCs visible at either top or bottom of the RFC. Might be a worthwile request in its own right.. An example of this is Basic debugging checklist. Note quite as visible as what I wanted, but certainly sufficient.
  • replacing the node with the most questionable and shortest ever tutorial on perlmonks: More or less hijack the node title of the list node, make the new node a suitable type and add the original content (if the old node should not be deleted, which is probably true, then make it link to the new).

Meta

  • It's not quite clear to me, why some 'used-like-tutorials' nodes have some comments and others have none and don't offer any way to comment. Maybe all should. Rather Not in the node itself: I'm quite hesistant to add questions and feedback to the tutorial node itself. IMHO this should be in a second node to manage it (size, load time, ability to ahem "log-rotate+archive" the comment/RFC thread).
  • Nodelet use seems to be growing on me slightly. But it looks like I missed or skipped too much about the PM internals when reading the FAQs on perlmonks itself. Either admonish-/me-aka-new_monk-to-rtfm(without-pointer-or-node-id) or tutorial quest omission.
    /me said with typos, somewhat extended here:
    "ps: =tutlist - tried supersearch body-text on it: it is mostly tough beans + permission denied -- are there any public (more highlevel overview, not detail nor internal discussion) descriptions of perlmonk.org's implementation and document (incl. organisation) structure available?"
    Also the wiki links I saw recently were all perm-denied, and one or two of them - with a bit of down-editing - might be suitable for public access and offer some the pm-site-basics (node-type info,...) I don't know yet. If copying to allow public access, (editor+pedagogue clan time should be conserved as a valuable resource, even if I abuse it now :> ), mark the copies 'info as of DATE'/'internal master-version is LINK', then you'd not even need to keep it in (tight) sync with the real restricted doc.

    Just added this to my 'missing PM-newbie meme-section' in jakobi: * know enough about PM-site structure and document types to not waste pedagogue or pmdev clan time due to trivial misunderstandings and invalid assumptions. These aren't sufficient for that worthy goal: Pmdev documentation, jdporter's site scratchpad, Editing DocLists, Restyling PerlMonks.
  • If I'm running against an open door here, but still think that it's a wall section that should be made into a door, than at least for this monk, it was _not_ visisble in the tutorial... . Turn what I mis-perceive into a tutorial quest entry?

jdporter -- re: tutorial quest - some more small fries

To be possibly added to Debugging and Optimization:

Please do add the RFC links as well, I think adding a comment is valuable as this allows the tip to be visible w/o requiring immediate change of the FAQ/tutorial by its author or sitedocclan; also allowing feedback and maturing. And I like the way toolic's debugging offers nodes for both.

Note I probably duplicate some already listed entries either as note for myself, but sometimes also differently lists, esp. when I can add the meta/rfc links or 'this is commentable thread' vs 'readonly', also note that I neglected to do this for advanced topics like Debugging Perl scripts which use fork() or Common Causes for "Modification of a read-only value attempted"; if these are included, they should go after say an <hr>).

I guess non-sitedocclan shouldn't comment in the tutorial section directly?

In the end I'd love to just copy/paste in a comment for obvious incomplete debugging questions in SoPW in case of xp < 20:


Please see [Debugging and Optimization] and update your post afterwards ;)

This would ensure that us commenters don't neglect to mention the debugging basic, but it also has enough pointers and keywords to get the opener started to fixing or giving more detail. Allowing monks to just post a link, but still providing a most terse, but useful and sufficiently complete RTFM+Pointer style comment, I hope...


Starting points

More specialized topics

  • (debugging and fork, upto strace -f -efile...)

All Tutorials.


Footnotes:
  • see ... for submitting questions.

    5 second sermon: condense and run, then paste, using <code>...</code> and possibly <readmore>...</readmore>. Test your pasted and condensed test input/output to be still valid, otherwise fall back to an external download link in case of paste/charset-encoding issues. Ensure that all of your example code, input and output are current both on your side as well as in the posted version.


which is NOT yet another tutorial, but rather slighly extending the current version of Debugging and Optimization in situ, which in plain texti currently is just this:


    * Benchmarking Your Code by turnstep
    * Profiling your code. by kyle
    * Debugging Perl scripts which use fork() by IlyaM
    * Common Causes for "Modification of a read-only value attempted" by imp
    * Basic debugging checklist by toolic

which I think suitable in size for a starting point to give to beginning users of perl. But it lacks links to feedback/comment threads for stuff not yet incorporated into the referenced faqs by Pedagogues (and feedback should be discussed and eyeballed by other monks before incorpating it!). And it maybe also lacks a very small bit of context, which currently must be provided each time when pointing someone to this page. Providing this context each and every time is repetitive, and I really don't trust myself to not miss or vary half of the context each time I'd paste a link to Debugging and Optimization

This request of course would be unnecessary, if such a SMALL Debugging Link List already exists for linking to in a comment. (but I didn't find one. I'd argue that a central SHORT resource such as this is better than a ton of personal ones, where e.g. I'm bound to miss half of the suitable nodes and fail to keep my own version suitably uptodate)

wrt small fries - that just refers to my remark in a thread a few days ago, where I wondered about what node to link when commenting debug-style beginner questions, which you added to the tutorial quest (thanx, btw). My suggestion here is just an attempt to make my small fry suggestion a bit more specific (and I've chosen plural, as I've extended it to include the RFC-links for each for the referenced tutorials)

Thanx for checking,
Peter





Stuff to stuff into the profile sections

sort, dedup, move with little or no commenting
Perl 5 <-> Perl 6 compatibility: a benefit or a mess?
Women in Perl - Ada Lovelace Day
Unparseability is A Good Thing
How to check if a scalar value is numeric or string?
True or False? A Quick Reference Guide
0 but true
What is true and false in Perl?
The best "true zero" is...
What is truth? (Curiosity corner)
How to check if a scalar value is numeric or string?
add: but don't try to be too cute, that will bite at the lastest in the maintenance phase.
Need some wisdom on strings to numbers
Graph Algorithm Package
Perlmonks Related Scripts
XML available for chatterbox and other users
What XML generators are currently available on PerlMonks?
Re: Large Scale Perl Projects
Not Exactly a Hash Tutorial
Fastest data structure compare?
passing regular expression
Top Seven (Bad) Reasons Not To Use Modules
Yes, even you can use CPAN
Re: Fastest data structure compare?
Help finding relevant modules to write a port forwarder from pool
ELISHEVA
Flipin good, or a total flop?
Things I Don't Use in Perl
Best Hash Practices?
keeping diacritical marks in a string
keeping diacritical marks in a string
keeping diacritical marks in a string
keeping diacritical marks in a string
Transcoding MIME Strings
Run Perl6 in your browser with sprixel
Downloading CPAN modules on WIndows....
Jifty: Is it worth learning?
XML::Twig help please
Not Exactly a Hash Tutorial
where do you put your subs
Yes, even you can use CPAN
Precedence/Prototypes - Re^2: Detecting when a child process is killed unexpectedly
The golf course looks great, my swing feels good, I like my chances (Part I)
Questions about creating CPAN modules
Re: *SAFE* use of string in system command
How to set variable names using Text::CSV?
find differences between multiple hashes
Re: Questions from "Coders at Work"
mmap in Perl?
mmap in Perl?
mmap in Perl?
mmap in Perl?
brian's Guide to Solving Any Perl Problem
Re: Perl backticks and GREP?
CGI ajax repeating input
Re: timelocal error when executed twice.
JSON and Perl Objects - How to access data?
Storable style de-serializing for JSON structures
JSON module
Javascript in your JSON
how to read conf file in perl script
XY Problem
How to choose the right module
Using WWW::Selenium To Test Or Automate An Ajax Website
conf file in Perl syntax
Nature of (Super )?Search queries ?
Using the Simple Search
Running SuperSearch off a fast full-text index.
Help Super Search Newbies
Re^2: a Moose CGIP shall not receive merlyn's blessing
XPath with node names and attributes...
Tao Te Ching Chapter 79
Re: can you autoflush a program in unix?
Social CPAN : Finding the best and most popular modules
Survey of POOP Modules (draft; please do not vote or reply)
jdporter's treehouse
Social CPAN : Finding the best and most popular modules
Social CPAN : Finding the best and most popular modules
Build a list of defined var's
Things I Don't Use in Perl
XYZ Questions
Re: can you autoflush a program in unix?
Re: can you autoflush a program in unix?
Mysterious Whitespaces between each character in a file
Parallel Fork Manager -- Can't kill zombies!
Detecting when a child process is killed unexpectedly
bad interpretor error when running scripts off an NFS share
Parallel Fork Manager -- Can't kill zombies!
USAGE OF Prototype
Find encoding that should have been used
Getting started with XML
http://perlgeek.de/en/article/5-to-6
XML::Lib XML question
reading from a file after a seek isn't working for me
Re^2: how to strip VT100 escape sequences?
mmap in Perl?
Re: Perl Test
sending variables to a script running in a bg
Monitoring Threads and keeping them alive/reviving them
How can I visualize my complex data structure?
Best practices, revisited
ELISHEVA's scratch non-scratchpad
Do my homework for me!
debugging perl bindings on a C library
Perl Best Practices
Re: Poor performances with threads
Managing objects/references across system boundaries
Catalyst: Using Chained for URL Dispatching and Sane Method Organization
pattern matching words in any order
Re: Poor performances with threads
pattern matching words in any order
lost in utf8
Implementing Dispatch Tables
Re: Massive regexp search and replace
(Revisiting) Smart match in p5
Massive regexp search and replace
Smart match in p5
Re: Dirge (Retrograde Amnesia) - Try PLEAC
How to use regex in Tree->look_down
Massive File Editing
Parsing with Regexes and Beyond
Re^4: check for square-number with a regex
Design Patterns Still Aren't
Perl falls victim to shifting trends
check for square-number with a regex
(tye)Re: Stupid question
Eternal question of parsing parentheses
Eternal question of parsing parentheses
Eternal question of parsing parentheses
Using Look-ahead and Look-behind
Help in Tough Times
Code Maintainability
On Coding Standards and Code Reviews
The value of declarations
On Coding Standards and Code Reviews
Getting Involved with Perl 6 - 2009
Some people, when confronted with a problem, think “I know, I'll use regular expressions.” Now they have two problems. (Big thanks to Corion for pointing me to this entry in Jeffrey Friedl's blog which gives the exact quote and researces its source.) "1 problem" =~ s/1/2/ and more monkquips Some people, when confronted with a problem, think "I know, I'll use regular expressions." Now they have two problems. -- Jamie Zawinski Whenever faced with a problem, some people say `Lets use AWK.' Now, they have two problems." -- D. Tilbrook
Eternal question of parsing parentheses
Eternal question of parsing parentheses
About the + in front of a hashref that disambiguates from a code block.
Succinct switch statement
can you autoflush a program in unix?
mmap in Perl?
mmap in Perl?
linux perl - interrupted system calls not restarted?
Perl Test
Perl Test
Re: Spanish translation of pack/unpack tutorial (location)
The world is not object oriented
What is a pipe and why would I want to use one?
Mastering Log::Log4perl
Re: mmap in Perl?
Windows viewpoint?-- Re^3: running programs from PERL
Windows viewpoint?-- Re^3: running programs from PERL
Mastering Log::Log4perl
SNMP Test for mib
On Coding Standards and Code Reviews
How to pick a CPAN module
Code Maintainability
Math::PARI and Crypt::RSA
Re: SNMP Test for mib
How to execute Net::OpenSSH remote command requiring input
Re: How to execute Net::OpenSSH remote command requiring input
Perl to monitor a table in database
The 10 stages of Bug hunting and the sweet smell of success
Tips for managing Perl projects?
pmdev user group
Simple Module Tutorial
On Responsible Considerations
Getting the XML node containing a search text...
tracking "stack smashing detected"
Mini-Tutorial: Perl's Memory Management
Re: replicate PERL environment
possibility to overcome perl threads
Moving and resizing application in X Window Manager
Testing IS Development
Using modular numbers with Math::Pari
On Interviewing and Interview Questions
Help in Tough Times
Professional Employees and Works for Hire
Interview Counterattack: "Show me a project-plan"
Interview Counterattack: "Show me a project-plan"
Interview Counterattack: "Show me a project-plan"
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 wandering the Monastery: (5)
As of 2024-03-19 09:07 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found