home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 14 Text / 14-Text.zip / writer.zip / WRITERS
Text File  |  1995-03-20  |  14KB  |  318 lines
  1.                                                                3/95
  2.                        _______________________
  3.  
  4.                        OS/2 DEVELOPER MAGAZINE
  5.                          WRITER'S GUIDELINES
  6.                        _______________________
  7.  
  8. "The Magazine for Advanced Software Development"
  9.  
  10. The OS/2 Developer is a bi-monthly publication founded by IBM in 1988
  11. and now owned by Miller Freeman, Inc.  It is aimed at both commercial
  12. and corporate OS/2 application developers.  Articles about OS/2
  13. features, functions, projects, tools, tips and techniques are
  14. solicited from OS/2 experts, software vendors and customers.  This
  15. document summarizes the requirements for submitting articles to the
  16. magazine.
  17.  
  18. We're looking for articles that...
  19.  
  20.  - Simplify the OS/2 application development process
  21.  - Explain OS/2 Warp features and functions that promote usability
  22.    and improve performance
  23.  - Provide how-to advice on graphical user interface, object
  24.    oriented programming, client/server, and other advanced programming
  25.    techniques
  26.  - Expedite conversion of DOS and Windows applications to OS/2 32-Bit
  27.    platform
  28.  - Create better applications using OS/2 development tools
  29.  - Share tips & techniques, questions & answers, programming examples,
  30.    and real life case studies
  31.  
  32.  
  33. OS/2 Developer Departments
  34.  
  35.   - Graphical User Interface           - Resources (seminars, books)
  36.   - OS/2 2.X (32-Bit)                  - Hardware Exploitation
  37.   - OS/2 Database Applications         - Graphics & Multimedia
  38.   - OS/2 Communication Applications    - Multi-User Systems
  39.   - OS/2 Local Area Networks           - OS/2 International
  40.   - Software Tools                     - Spotlight Feature
  41.   - Application Enablers               - Performance
  42.   - Systems Application Architecture   - Manufacturing
  43.   - Client/Server Programming          - Object Oriented Programming
  44.   - Printing                           - Product Watch
  45.   - The Advanced Novice                - Speech Recognition
  46.  
  47.  
  48. OS/2 Developer Features & Columns
  49.  
  50.   - Programming Insider (Dave Reich)   - Product Watch
  51.   - GUI (Mark Benge and Matt Smith)      (New OS/2 tools & utilities)
  52.   - Tools Reviews (Guy Scharf)         - Buyer's Guide
  53.                                          (OS/2 tools supporting the
  54.                                          theme of each issue)
  55.  
  56. Compensation
  57.  
  58.   OS/2 Developer currently does not pay for submitted articles.
  59.   However, many of our authors have received offers to write books
  60.   and speak at technical conferences.  IBM employees receive
  61.   compensation from their site Author Recognition programs.
  62.  
  63.  
  64. STEP 1:  Nominating an Article
  65.  
  66.  - Send a short outline of your article to the Editor.  Estimate the
  67.    number of drawings, screen shots, and lines of source code.  In
  68.    which department (see above) does the article belong?
  69.  
  70.  - We will give you a tentative yes or no for inclusion in an upcoming
  71.    issue.  Upon receipt of final copy, we will confirm our intent to
  72.    use your material.  We reserve the right to use or reject an
  73.    article at any time.  Generally, theme articles (see Calendar) take
  74.    priority.  
  75.  
  76.  
  77. STEP 2:  Submitting Your Article
  78.  
  79.        * * * ALL ARTICLES MUST FOLLOW THESE GUIDELINES * * *
  80.  
  81.  - Deadline:  send the article text (softcopy) to the Editor before
  82.    the published deadline (see calendar).
  83.  
  84.  - Content:  5 - 7 pages maximum, single-spaced.  Keep the article
  85.    brief by summarizing the main points, using illustrations and short
  86.    examples, and by referencing other sources.  Remember:  you may not
  87.    be able to tell your readers everything they'll need to know about
  88.    a programming technique or software tool in one article.  Cover the
  89.    highlights and refer readers to reference publications for more
  90.    detail.  Excessively long articles will be returned for rewriting.
  91.    Priority should be given to OS/2 Warp 32-bit functions, examples,
  92.    tools and applications.  Please, no PR pieces!  Make sure your
  93.    article reflects the latest release of OS/2.  And remember -- you
  94.    are writing for developers, not end users.  Our readers want
  95.    articles with hands-on, how-to programming examples, with actual
  96.    working code.  Appeal to their technical knowledge.
  97.  
  98.  - Software tools:  An OS/2 software development tool may be described
  99.    in your article, as long as it is secondary to the technical theme.
  100.    In other words, it's OK to review a tool's features, but our
  101.    readers are looking for ways to write better applications.  Start
  102.    by defining a problem or application development scenario that the
  103.    tool addresses.  Give examples and case studies.  Save the product
  104.    features and functions for last.
  105.  
  106.  - Security:  unclassified at time of publication.  If product hasn't
  107.    shipped, include a disclaimer saying that function may be added,
  108.    deleted, or changed in the final product.
  109.  
  110.  - File format:  Store the article text in a file by itself, separate
  111.    from artwork.  Use the DOS ASCII format, free of any formatting or
  112.    control characters.  Margins:  flush left, no hyphenation, width
  113.    70.  Include references and captions for all artwork, e.g.,
  114.    <insert Figure 3 - screen shot - "Display of Coding Example">.
  115.    Name the file after the author contact's last name (SMITH, JONES,
  116.    etc.).  Send the file to the Editor electronically or on a 3.5-inch
  117.    diskette.
  118.  
  119.  - Title:  Keep title short and simple, e.g., "Using 32-Bit APIs to
  120.    Improve Performance".
  121.  
  122.  - Identifying information:  At the top of your article, please
  123.    include the following:
  124.  
  125.      Article title:
  126.      Issue:                     Section:
  127.      Author contact:
  128.      Author phone:
  129.      Fax:
  130.      E-mail:
  131.      Address:
  132.  
  133.  - Headings:  Show level of each heading (use two heading levels and
  134.    bulleted lists beyond that).  Example:  Improved Performance
  135.    <head>, Final Fine-Tuning <subhead>.
  136.  
  137.  - Artwork:  Keep diagrams, tables, etc.  separate from the text file;
  138.    fax or mail your sketches to us (we redraw all illustrations, so
  139.    don't spend time creating computer diagrams).
  140.  
  141.  - Code listings:  May be added at the end of the article.
  142.    Well-commented, width 70.  Be sure to test your code!  Give each
  143.    code segment a figure number and caption.  Limit your code examples
  144.    to the minimum number of instructions needed to make a point.  If
  145.    you like, you can also give us a separate file containing a full
  146.    sample program ready for compilation.  We'll put it in our
  147.    CompuServe OS2DF2 library for downloading by our readers.  If you
  148.    do this, refer to the CompuServe file in your article.  That file
  149.    should be commented as follows:
  150.  
  151.      /* Program name:  XXXXXXXX.XXX  Title:                       */
  152.      /* OS/2 Developer Magazine, Issue: XXXXXX '95, page XXX      */
  153.      /* Article title:                                            */
  154.      /* Author:                   Phone:          Fax:            */
  155.      /* Description:                                              */
  156.      /*                                                           */
  157.      /* Program requirements:                                     */
  158.      /*                                                           */
  159.  
  160.  
  161.  - Screen shots:  We have a screen capture program which creates .PCX
  162.    format files.  Please request a copy from the Managing Editor or
  163.    use a compatible program.  No screen photos.  Limit: three or
  164.    four screens per article.  Include references and captions in your
  165.    article text.
  166.  
  167.  - Authors:  Credit all authors, designating one person as our contact
  168.    person.  A short, one-paragraph biography (see previous issues for
  169.    examples) with a mug shot (color or black and white) must be
  170.    provided of each author.  Include your current job title,
  171.    responsibilities, career milestones, college and degrees, company
  172.    address, e-mail ID and phone number in your bio.
  173.  
  174.  - References:  Include a References box at the end of the article.
  175.    List all bibliographic references:  book or article titles,
  176.    publisher, city and date of publication, and page numbers if
  177.    applicable.  If a reference is an IBM publication, include its IBM
  178.    order number (eg., G362-0001-02).  If you refer to a publication in
  179.    the text, list it under References.  References can include any
  180.    hardcopy or disk-based information shipped with OS/2 or a software
  181.    tool.
  182.  
  183.  
  184. STEP 3: Reviews and Approvals
  185.  
  186.  - IBM authors:  Site review (Communications, Legal, Intellectual
  187.    Property Law) is required; check to see if your site has an Author
  188.    Recognition Program (ask your manager or site communications
  189.    department).  Make all review changes during the editing cycle.
  190.  
  191.  - Multiple authors:  Designate one author as our prime contact.  This
  192.    person is responsible for procuring all art, photos, etc., and
  193.    distributing galleys for correction to other authors.
  194.  
  195.  - Author release:  Miller Freeman, Inc. requires you to sign a
  196.    release form that certifies the article's originality.  Generally
  197.    we want articles that have not been published elsewhere.  Book
  198.    excerpts may be used if the publisher gives permission.
  199.  
  200.  - Selection:  Articles must be submitted by the published deadline
  201.    unless a later date is approved by the Editor.  Late submissions
  202.    are accepted on a first-come basis where last in is first bumped.
  203.    We do overbook, so if your article is bumped from an issue, it may
  204.    be a candidate for the next one.  Selection criteria include
  205.    conformance to these guidelines, the theme of the issue, article
  206.    length, and the number of available editorial pages.
  207.  
  208.  
  209. STEP 4:  The Pre-Production Cycle
  210.  
  211.  - The Editor will review and edit your submission and forward it to
  212.    the Managing Editor, who will contact you about grammatical editing
  213.    and artwork.  Your article will be faxed to you with editorial
  214.    changes for your review.  You will see the article once again in
  215.    page-layout (camera ready) format for final approval.  Only typo
  216.    corrections and emergency changes should be made to this version.
  217.    Either the prime author or a knowledgeable representative must be
  218.    available during this period to ensure quick turnaround.
  219.  
  220.  - IMPORTANT:  once you send us a softcopy of your article, don't
  221.    continue to make changes to your file or you'll get out of sync
  222.    with the in-edit version.  Instead, give your changes to the
  223.    Managing Editor by fax or telephone.  Once the article is in
  224.    production, there should be no rewrites.
  225.  
  226.  
  227. Post Production
  228.  
  229.    We encourage authors to communicate with readers and with each
  230.    other.  Join the OS/2 Developer Mag section on CompuServe (GO
  231.    OS2DF2).
  232.  
  233.  
  234.                             OTHER INFORMATION
  235.  
  236. Reprints
  237.  
  238.  - Article reprints may be ordered from Miller Freeman.  Quantity
  239.    prices are furnished on request.  Call Stella Valdez at Miller
  240.    Freeman, 415-655-4269.
  241.  
  242.  
  243. Editorial Calendar   (revised 3/95)
  244.  
  245.     Issue             Theme                       Articles Due
  246.     ~~~~~             ~~~~~                       ~~~~~~~~~~~~
  247.  
  248.   JULY / AUG:   OOP; Taligent Frameworks;      March 27, 1995
  249.                 OpenDoc
  250.  
  251.   Rexx Report   Special issue on OS/2 Rexx     March 27, 1995
  252.                 Application Development
  253.  
  254.   SEPT / OCT:   OS/2 for PowerPC; Database     May 29, 1995
  255.                 Development
  256.  
  257.   Smalltalk     Special issue on OS/2          ??
  258.   Report        Smalltalk Application Dev.
  259.  
  260.   NOV / DEC:    Client/Server Development;     July 31, 1995
  261.                 Downsizing
  262.  
  263.  
  264. Advertising
  265.  
  266.  - The OS/2 Developer is the best way to reach the OS/2 community with
  267.    news of software tools, publications, products and services.  Ad
  268.    rates and schedules can be obtained from:
  269.  
  270.       Yvonne Labat           415-905-2353
  271.       Kristin Morgan         212-626-2498
  272.       Christian O'Brien      212-626-2322
  273.  
  274.  
  275. Subscriptions
  276.  
  277.  - Through the Publisher:  Miller Freeman Inc., (800) WANT-OS2 ($39.95
  278.    yearly).  Outside of U.S.: 708-647-5960 or e-mail SHall@MFI.Com.
  279.  
  280.  - Through IBM:  Systems Library Subscription Service (SLSS) order
  281.    number G362-0001.  Copies of current issue can be ordered through
  282.    PUBORDER.  (Note:  SLSS is accessed on the HONE system; PUBORDER on
  283.    VM).
  284.  
  285.  - Members of IBM's U.S. Developer Assistance Program may apply for a
  286.    qualified (free) subscription.  Call 800-WANT-OS2 and ask for a
  287.    qualified subscription application.
  288.  
  289.  
  290. Book Compilations
  291.  
  292.    "OS/2 2.X Notebook", published by Van Nostrand Reinhold in
  293.    February, 1993, contains articles from OS/2 Developer, 1991-1992.
  294.    Available in book stores, from IBM (order number G362-0015), or
  295.    direct from the publisher, (800) 842-3636.  The original OS/2
  296.    Notebook (1990) is available from IBM (order number G362-0003).
  297.  
  298.  
  299. Staff
  300.  
  301.    Publisher:        Peter Westerman, (415) 905-2392
  302.                      Internet: PWesterman@MFI.Com
  303.                      Mail: Miller Freeman, Inc., 600 Harrison St.,
  304.                            San Francisco CA 94107
  305.    
  306.    Editor-in-Chief   Dick Conklin, voice/fax (407) 495-4421
  307.                      CompuServe: 76711,1005
  308.                      Internet: OS2MAG@VNET.IBM.COM
  309.                      IBM: BCRVM1(CONKLIND), IBMMAIL(USIB12H2)
  310.                      Mail: 3408 Sherwood Blvd.,                 
  311.                            Delray Beach, FL 33445
  312.  
  313.    Managing Editor:  Marta Dils, (415) 905-2777, Fax (415) 905-2234.
  314.                      Internet: MDils@MFI.COM
  315.                      Mail: Miller Freeman, Inc., 600 Harrison St.,
  316.                            San Francisco CA 94107
  317.  
  318.