home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / etc / hacklaw / artspec.doc < prev    next >
Encoding:
Text File  |  2003-06-11  |  9.0 KB  |  248 lines
  1. FidoNews Article Submission Guidelines
  2. FidoNet address 1:1/23
  3. Updated 29 May 1991 by Tom Jennings
  4. Based on the original work by Thom Henderson
  5.  
  6. "Fido" and "FidoNet" are registered trademarks of Tom Jennings, 
  7. Box 77731, San Francisco CA 94107, USA and are used with 
  8. permission.
  9.  
  10. --------
  11. SYNOPSIS:
  12.  
  13. FidoNews is the newsletter of the FidoNet computer network, its 
  14. sysops and users. It is passed to its readers electronically via 
  15. the FidoNet and other computer networks and to non-network 
  16. readers as well.
  17.  
  18. This document intends to tell you how to write and submit 
  19. articles for publication in FidoNews. Much of it describes the 
  20. technical specifications which an article must meet in order to 
  21. be included in the newsletter, as well as broad (very) guidelines 
  22. on content. (Of course you realize articles can be submitted only 
  23. electronically.) Please read it carefully. The article you save 
  24. might be your own.
  25.  
  26.  
  27. ------------
  28. INTRODUCTION:
  29.  
  30. FidoNews was originally founded in early 1984 to include all 
  31. parts of the lives of its member sysops and users, which of 
  32. course means not just technical matters. We do not have fixed 
  33. goals of maximum distribution or maximum readership (ie. lowest 
  34. common denominator) but only to meet the needs of our individual 
  35. network members. The success of this venture has always been 
  36. contentious at best (ahem).
  37.  
  38. In any case the grand experiment continues. Seven years later (at 
  39. this writing) and nearly six doublings in size of the network, 
  40. the editorial policy, or lack of one, of FidoNews has shown to 
  41. best fit our ever-changing and unpredictable needs.
  42.  
  43.  
  44. --------------
  45. SUBJECT MATTER:
  46.  
  47. Articles on any subject of interest to FidoNet members and users 
  48. are welcome and encouraged, not necessarily of a technical 
  49. nature, though priority may be, but not necessarily, given to 
  50. articles of importance to the FidoNet, its technology and its 
  51. uses; other networks such as uucp and the Internet; social 
  52. aspects of communications; ethical issues; other related matters. 
  53.  
  54.  
  55. --------------
  56. ARTICLE LENGTH:
  57.  
  58. Try to keep articles short. The longer it is, the less likely
  59. people are to read it. Consider splitting long articles (more
  60. than five pages) into smaller articles to be run serially.
  61. Exceptions will be made at the whim of the editors. 
  62.  
  63. For practical reasons, we will attempt to keep FidoNews to a 
  64. "reasonable size", which is of course a highly subjective and 
  65. variable thing. As of May 1991, the goal is under 100,000 bytes. 
  66. Decisions regarding content may be made based upon this, though 
  67. in general it shouldn't be an issue.
  68.  
  69.  
  70. ------------------
  71. WRITING GUIDELINES:
  72.  
  73. We are not all professional writers, nor is that even a goal for 
  74. the FidoNews -- we want real communication to and from real 
  75. people; even at the expense of so-called "good writing", which is 
  76. frequently a tool to exclude. There are a few minimum 
  77. requirements though for any successful writing, even for the 
  78. lowly FidoNews:
  79.  
  80. * The subject discussed must clear to people other than the 
  81.   author! Don't assume that people will pickup the context from 
  82.   your writing. Tell them explicitly.
  83.  
  84. * Why are you writing this? It may seem obvious -- "Review of the 
  85.   new Acme 75-baud Modem" -- but it's not. Are you the 
  86.   manufacturer? An irate customer? Let us know your point of 
  87.   view.
  88.  
  89. * Who are you? A good question! Anonymity is acceptable, though 
  90.   most people want to take credit for their work. Include full 
  91.   contact information including electronic mail addresses.
  92.  
  93. * Articles will appear when space becomes available, not 
  94.   necessarily the "next" issue. If your article is of a time-
  95.   critical nature, please say so when you submit it; the editor 
  96.   still has final say.
  97.  
  98. * The editor reserves the right to request changes from an author 
  99.   to meet these "standards", which you have to admit are pretty 
  100.   loose. It is not the intent for this to be a mechanism to 
  101.   refuse articles the editor does not like, but simply to keep 
  102.   the contents intelligible.
  103.  
  104. * If we have a backlog of articles, we may get fussier about 
  105.   things. Historically this has not been a serious problem.
  106.  
  107.  
  108. ---------------------
  109. SUBMITTING AN ARTICLE
  110.  
  111. TECHNICAL REQUIREMENTS:
  112.  
  113. If all that hasn't scared you away, the next step is to create a 
  114. text file which contains the text of your article. The resulting 
  115. file should be sent or uploaded to "FidoNews", FidoNet address 
  116. 1:1/23. The "physical" location (and phone number) of FidoNews 
  117. varies, and hence must be found elsewhere, such as within a 
  118. recent copy of FidoNews itself.
  119.  
  120.  
  121. Filenames must follow the MSDOS standard:
  122.  
  123.     FILENAME.TYP
  124.  
  125.     an 1 to 8 character file name (A - Z, 0 - 9)
  126.     a period,
  127.     a 0 to 3 character file type (A - Z, 0 - 9)
  128.  
  129.  
  130. File types are used to distinguish types of submissions, as 
  131. follows:
  132.  
  133.     .ART An article, commentary, open letter, or general news 
  134.          item.
  135.     .AD  "For Sale", "Wanted" or other advertisement.
  136.     .NOT A notice for the back of the issue.
  137.  
  138. If your file doesn't have one of the above extensions, then it 
  139. will lay around taking up disk space until someone takes a look 
  140. at it and realizes what it is. Maybe.
  141.  
  142. The name of the file is up to you, though you should use a name 
  143. which is not likely to be "stepped on" by someone else -- the 
  144. system will not guarantee file names are unique. For example, 
  145. FNEWS.ART is probably not a good name for an article.
  146.  
  147.  
  148. --------------
  149. CHARACTER SETS:
  150.  
  151. The character by character contents of the file itself must meet 
  152. the following standards or it cannot be published in FidoNews. 
  153. The FidoNews staff will not be responsible for making file 
  154. contents conform to these standards.
  155.  
  156. * FLUSH LEFT MARGIN: Please do not put a "left margin" on your 
  157.   articles. Have the text start at the very first column.
  158.  
  159. * RIGHT MARGIN AT COLUMN 72 OR LESS: Less is tolerable, more is  
  160.   definitely not. 
  161.  
  162. * RAGGED-RIGHT TEXT: Word-Star style "justification" (inserting
  163.   spaces into sentences so that a paragraph is perfectly rec-
  164.   tangular) is extremely hard to read, and consumes needless space. 
  165.   Please don't use it!
  166.  
  167. * NO FUNNY CHARACTERS: This includes formfeeds, returns without  
  168.   linefeeds, linefeeds without returns, tabs and other oddities. 
  169.   The only control codes (character codes 0 through 31 decimal) 
  170.   allowed are carriage return (CR) and linefeed (LF). The only 
  171.   exception is: Control-Z "end of file" terminator characters are 
  172.   tolerated. Not required.
  173.  
  174. * NO GRAPHICS CHARACTERS: Believe it or not, not everyone in the  
  175.   world has an IBM PC. Please restrict yourself to printable 
  176.   ASCII characters in the range 20 hex to 7E hex (space to 
  177.   tilde).
  178.  
  179. * LINES TERMINATED: Each line in the article should be terminated 
  180.   with a 'newline' -- either the MSDOS standard (CR/LF) or the 
  181.   unix standard (LF only).
  182.  
  183.  
  184. -----------------
  185. SUBMISSION FORMAT:
  186.  
  187. Below is a sample article properly formatted. Features of it are 
  188. discussed further below.
  189.  
  190.  
  191.  
  192.  
  193.  
  194. * A Sample Article 
  195.  
  196. by Joe Schmoe
  197. This Is My Title
  198.  
  199. And here is my article. Note that it is flush left (zero indent). 
  200. Also note that the right margin is at column seventy so that it 
  201. won't overflow "most" text windows. Each line has a newline. Note 
  202. the *'ed first line. My article will be listed in the table of 
  203. contents.
  204.  
  205. Figure 1.                       Table 1.
  206.         +-------+               ========
  207.         | A Box |                  Alfa  
  208.         +-------+                 Bravo
  209.  
  210. Note that we am not using any funny-o characters. This ensures 
  211. that the final article will look the same to every user, no 
  212. matter what sort of hardware he has.
  213.  
  214. This is the last sentence of our article.
  215.  
  216.  
  217.  
  218.  
  219.  
  220. The first line of text is the Table of Contents line. It must 
  221. begin with an asterisk * as shown above. If you do not, the 
  222. article will not be listed in the table of contents.
  223.  
  224. * Everything that follows the *'ed line will appear in the body 
  225.   of the newsletter.
  226.  
  227. * Next should be the title or name of your article, your name, 
  228.   and contact information (network address(es), Postal Service 
  229.   address, etc) Try to keep it to one or two lines each.
  230.  
  231. * Put a blank line between paragraphs. Paragraphs that all run 
  232.   together are very difficult to read, and may be rejected.
  233.  
  234. * If you want to put in a table or a figure, go right ahead. 
  235.   We do not rearrange text, so your table or figure will 
  236.   remain exactly as you entered it. Try to limit them to ones 
  237.   that make the communication CLEARER. 
  238.  
  239. * Don't put a lot of blank space at the top or bottom. The 
  240.   FidoNews-generator programs will visually separate articles 
  241.   automatically.
  242.  
  243. * Please check for basic errors in spelling, grammar, and 
  244.   punctuation. We're not publishing a textbook, but you don't 
  245.   want it to embarrass yourself do you?
  246.  
  247. -- END
  248.