Path: csiph.com!usenet.pasdenom.info!aioe.org!.POSTED!not-for-mail From: Dr J R Stockton Newsgroups: comp.lang.javascript Subject: Re: Potential FAQ mechanism on GitHub Date: Wed, 12 Dec 2012 21:27:24 +0000 Organization: Home Lines: 41 Message-ID: References: <5e684468-d1ae-4a31-a5b7-cba01316b6cc@u19g2000yqj.googlegroups.com> NNTP-Posting-Host: JfH6RRPWQh8XzArFI0xgxA.user.speranza.aioe.org Mime-Version: 1.0 Content-Type: text/plain;charset=us-ascii X-Complaints-To: abuse@aioe.org User-Agent: Turnpike/6.05-S () X-Notice: Filtered by postfilter v. 0.8.2 Xref: csiph.com comp.lang.javascript:17686 In comp.lang.javascript message <5e684468-d1ae-4a31-a5b7-cba01316b6cc@u1 9g2000yqj.googlegroups.com>, Sun, 9 Dec 2012 20:12:41, Scott Sauyet posted: > >Or do you think this is a waste of time? Should I not be pursuing >this idea at all? If so, please let me know why. It will not work as a provider of a FAQ suitable got a general purpose Usenet JavaScript group. A few experts with nothing better to do will compete in adding complications. The thing that is needed is clarity of thought in the planning of the content of the FAQ. For example, analyse "9.4 How do I modify the content of the current page?". The question is clearly not what it should have been (IIRC, I asked it) - it should (for me) refer to the visual textual content. The answer should be along the lines of (1) Decide on or create the element to be modified (2) Obtain a reference to the desired element of the page (3) Assign to the property of the element that controls its appearance in the desired manner. Lines should link to appropriate new sections. For that question as written, the modification might include hiding and un-hiding, moving in an XY sense, repositioning in the DOM tree, altering the CSS in a button, etc. The answer should include everything compatible with the chosen wording of the question. A FAQ should rarely include the questions literally as actually asked; but it should include questions that the questioner will recognise as answering what he was thinking of asking. -- (c) John Stockton, nr London, UK. For Mail, see Home Page. Turnpike, WinXP. Web - FAQ-type topics, acronyms, and links. Command-prompt MiniTrue is useful for viewing/searching/altering files. Free, DOS/Win/UNIX now 2.0.6; see .