View previous topic :: View next topic |
Author |
Message |
Cogito-Ergo-Sum Advanced
Joined: 15 Dec 2002 Posts: 637 Topics: 43 Location: Bengaluru, INDIA
|
Posted: Thu Jul 17, 2003 11:35 pm Post subject: RTFM - Search Repository |
|
|
Kolusu/Dalaly,
As we all know that a large number of questions asked here or elsewhere would have been never been posted if the topic starter had gone through the manuals. I want to share my experience and would like to suggest a way to aid in RTFM.
For example, I ask, "How do I run a TSO command (say, the SE command) in batch"? Obviously, the commonest answer is RTFM. In case of magnanimous (there are many) responders, they paste the URL in their replies. It is easy to understand the mind of a person with decades of mainframe experience. They would be simply put off by such one-line questions and may not post the URL and simply ask me to RTFM.
In such a scenario, I goto IBM site. What do I see? Thousands of topics and each topic having hundreds of manuals for it. I will be despaired and wring my hands helplessly. Which book should I look into? Which topic in that book should I browse?
I might search for TSO commands. There will be lots of hits for it. Assuming I goto the right manual, I may still not have RTFM. Because, I do not know, I have to look for IKJEFT01.
To help in RTFM (but, not necessarily eliminate questions which evoke RTFM type of anwers), I suggest you start having a "Search Repository".
Any user who pastes a link must be immediately prompted to goto a page where s/he can enter information about the link. Information such as, URL itself, site name, what question did it answer, etc. Such a page would enable users to goto this page. They would look for already "searched topics" and reduce one-liner posts.
I hope I am clear about my idea. Of course, others may have different ideas. The final decision to fructify this idea is also yours. As a regular at this site, I thought I must share my idea with you all so as to benefit other users too. _________________ ALL opinions are welcome.
Debugging tip:
When you have eliminated all which is impossible, then whatever remains, however improbable, must be the truth.
-- Sherlock Holmes. |
|
Back to top |
|
|
Venkata Ramana Reddy Beginner
Joined: 02 Dec 2002 Posts: 70 Topics: 19 Location: California
|
Posted: Fri Jul 18, 2003 10:16 am Post subject: |
|
|
Cogito-Ergo-Sum,
I like your idea. _________________ Venkataramana
-- Good judgement comes from experience, and often experience comes from bad judgement. |
|
Back to top |
|
|
Cogito-Ergo-Sum Advanced
Joined: 15 Dec 2002 Posts: 637 Topics: 43 Location: Bengaluru, INDIA
|
Posted: Fri Jul 18, 2003 10:19 am Post subject: |
|
|
Venkata Ramana Reddy,
Thank you. Let us see, if it appeals to Kolusu and Dalaly. Maybe we should start lobbying? _________________ ALL opinions are welcome.
Debugging tip:
When you have eliminated all which is impossible, then whatever remains, however improbable, must be the truth.
-- Sherlock Holmes. |
|
Back to top |
|
|
kolusu Site Admin
Joined: 26 Nov 2002 Posts: 12375 Topics: 75 Location: San Jose
|
Posted: Fri Jul 18, 2003 5:10 pm Post subject: |
|
|
Cogito,
It is a good idea and it has been already a work in progress. I am editing the board's most commonly asked questions and am planning to create a downloadable file which can be used as a reference. It is a major work and I plan to roll out one with all the tips and tricks of mvs.If any one would like to contribute please send an email to kolusu@mvsforums.com with subject tips and tricks of mvs.
Thanks
Kolusu |
|
Back to top |
|
|
Cogito-Ergo-Sum Advanced
Joined: 15 Dec 2002 Posts: 637 Topics: 43 Location: Bengaluru, INDIA
|
Posted: Sun Jul 20, 2003 10:46 pm Post subject: |
|
|
Kolusu,
It is really nice to know that the idea is already implementation. But, I was just wondering that maybe it is better to have a link in this site that would enable users to add or use already searched links. This is unlike the downloadable file which is kind of 'static'. Nevertheless, that downloadable file too will be of immense help. _________________ ALL opinions are welcome.
Debugging tip:
When you have eliminated all which is impossible, then whatever remains, however improbable, must be the truth.
-- Sherlock Holmes. |
|
Back to top |
|
|
stansaraczewski Beginner
Joined: 06 Sep 2006 Posts: 44 Topics: 13 Location: Southern California
|
Posted: Thu Sep 07, 2006 3:08 pm Post subject: |
|
|
I'd like to submit my opinion regarding 'RTFM'.
Over the years, I have avoided using that response unless the person is trying to get me to do his work. Case in point once an applications programmer walked up to my desk and announced that he had gotten error "abc123I" (I've forgotten the exact number).
This is where the RTFM reply can be appropriate... I asked him what the message manual told him to do and he resonded that he hadn't looked it up. I told him to go do so, then return if he didn't understand the prescribed action.
On the other hand, if someone has made an effort and is still clueless I feel that is my duty to provide a high level direction. Usually a light illuminates above the persons' head as comprehension sets in... and he/she is on the way, down the road.
Like a person said earlier in this thread - there is so much information available it would take many hours to sift thru it... one dead end after another can get very discouraging.
We all started somewhere, and I certainly feel I owe the beginners the same courtesy that was given to me when I started in this field.
|
|
Back to top |
|
|
Cogito-Ergo-Sum Advanced
Joined: 15 Dec 2002 Posts: 637 Topics: 43 Location: Bengaluru, INDIA
|
Posted: Tue Jun 03, 2008 2:20 pm Post subject: |
|
|
Wow ! Looking at this old post of mine, this idea has now become big time hit in Web2.0 these days. Maybe, we should leverage all this social software.
del.icio.us
Dogear IBM Research Center
hmm...should have filed a patent.... _________________ ALL opinions are welcome.
Debugging tip:
When you have eliminated all which is impossible, then whatever remains, however improbable, must be the truth.
-- Sherlock Holmes. |
|
Back to top |
|
|
dbzTHEdinosauer Supermod
Joined: 20 Oct 2006 Posts: 1411 Topics: 26 Location: germany
|
Posted: Wed Jun 04, 2008 1:58 am Post subject: |
|
|
Finding manuals on the web _________________ Dick Brenholtz
American living in Varel, Germany |
|
Back to top |
|
|
semigeezer Supermod
Joined: 03 Jan 2003 Posts: 1014 Topics: 13 Location: Atlantis
|
Posted: Wed Jun 04, 2008 12:06 pm Post subject: |
|
|
I have the following code on my home page. Adding it to the site might help. It is the search form for the IBM z/OS 1.9 pubs.
Code: |
<form name="textsearch" method="get"
action="http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/Shelves/EZ2ZO10K">
<input maxlength="200" size="18" name="searchRequest">
<input type="submit" value="Search z/OS Manuals" name="SEARCH">
<input type="hidden" value="FUZZY" name="Type">
<input type="hidden" value="TOPIC" name="SearchTopic">
<input type="hidden" value="TEXT" name="searchText">
<input type="hidden" value="INDEX" name="searchIndex">
<input type="hidden" value="RANK" name="rank">
</form> |
_________________ New members are encouraged to read the How To Ask Questions The Smart Way FAQ at http://www.catb.org/~esr/faqs/smart-questions.html. |
|
Back to top |
|
|
kolusu Site Admin
Joined: 26 Nov 2002 Posts: 12375 Topics: 75 Location: San Jose
|
|
Back to top |
|
|
Cogito-Ergo-Sum Advanced
Joined: 15 Dec 2002 Posts: 637 Topics: 43 Location: Bengaluru, INDIA
|
Posted: Wed Jun 04, 2008 1:12 pm Post subject: |
|
|
Nice !
But, they are so not Web2.0 ! _________________ ALL opinions are welcome.
Debugging tip:
When you have eliminated all which is impossible, then whatever remains, however improbable, must be the truth.
-- Sherlock Holmes. |
|
Back to top |
|
|
|
|