|Keep It Simple, Stupid|
About the sections of PerlMonksby SiteDocClan
|on Aug 11, 2005 at 19:04 UTC||Need Help??|
About the sections of PerlMonks
The Tutorials page has two layers: the "top" layer is Tutorials, which is a superdoc. It contains three components: the Tutorial Categories doclist, the Tutorials sitedoclet, and the "Add a tutorial" form. As a convenience, the "Edit" link in the top right corner of 954 actually takes you to the edit page for 510154.
SiteDocClan: because Tutorials is a doclist, with its own free-text field at the top, there is essentially no need for the Tutorials sitedoclet. It should probably be left empty. (It would be rendered below the doclist anyway.)
Writing obfuscated code is a favorite pastime of some Perl hackers. The basic principle is that the code should be as close to impossible to figure out by visual inspection as you can make it.
Closely related to obfuscated code is the game of golf: trying to solve a given programming problem in as few keystrokes as possible. The results can be, but are not necessarily, obfuscated.
Both types of "fun code" — obfu and golf — are suitable for posting in this section.
Some tips for writing/decoding obfu:
Snippets was an old section intended for the posting of very small bits of code — e.g., one-liners. It was redundant with Cool Uses For Perl, and so was put out to pasture (i.e. disabled). All new code postings (other than obfu and poetry) should be done in CUFP.
Code Catacombs was an old section intended for the posting of substantial chunks of code (scripts, modules, etc.) It was superceded by Cool Uses For Perl, and subsequently put out to pasture (i.e. disabled). All new code postings (other than obfu and poetry) should be done in CUFP.
The Monastery Gates, aka The Front Page
About the Newest Nodes view
Newest Nodes is an up-to-the-moment listing of all the nodes which were created since "the last time you checked".
You can opt to see or not see any of the sections in Newest Nodes.
Perhaps the most important control over Newest Nodes is your "last checked" time. Whenever you click the "I've checked all of these" button on Newest Nodes, your "last checked" field is set to the time at which the Newest Nodes page was loaded — in other words, the point in time up to which you've see nodes listed.
If this field is set, Newest Nodes uses the date/time stored there as a limit for how far back to show you "new" nodes. (However, 60 days is the hard limit. If your "last checked" value is older than that, only 60 days' worth of nodes will be shown. Note also that no more than 7 days' worth of replies are ever shown, regardless of the setting of this field, due to server load considerations.)
If this field is unset (i.e., cleared), then Newest Nodes lists nodes created during the preceding 24-hour period, and gives you a selection widget to view optionally up to 14 days of recent nodes.
If you're the type who checks Newest Nodes several times throughout the day, you can click "I've checked all of these" each time, so that the subsequent render of the page only shows you what's really new. If you ever decide, "Aw, my 'last checked' time is too recent; I want to see older nodes," then you can click the "Clear my 'last checked' time" button; this clears out the date/time value stored in that field. (And of course, there is always Super Search for maximally flexible node listing.)
Clearing your "last checked" time is also useful if it is set to some time in the distant past — for example, if you're away from the Monastery for a long time. You don't need to worry about overtaxing the server in this case, however, since Newest Nodes will never show you more than 60 days' worth of nodes, regardless of how far back your "last checked" time is set.
This "last checked" value, if set, is used in a few other places in the Monastery as well:
Back to the PerlMonks FAQ
Craft was an old section intended for the posting of substantial chunks of code (scripts, modules, etc.) It was superceded by Code Catacombs and Cool Uses For Perl, and subsequently put out to pasture (i.e. disabled). All new code postings (other than obfu and poetry) should be done in CUFP.