Help:Step-by-step guide to publishing an article on Scholarpedia

From Scholarpedia
Jump to: navigation, search

    Welcome!

    Scholarpedia is a peer-reviewed encyclopedia written by the leading experts in their respective fields. As an encyclopedia, it does not publish research papers or position papers but instead is meant to serve as a repository for "living reviews" to be maintained by future generations of experts via a process of curatorship.

    If you would like to publish an article on Scholarpedia, please follow the steps below.

    Contents

    Step 1: Create a user account

    1. At the top right of the main page, click “Log in / create account.”
    2. Under “Log in,” click “create an account,” and then fill in all of the required fields.

    Step 2: Propose an article

    Click Propose a new article, and type in the proposed article title and deadline for completion. Your title should be short and encyclopedic.

    The article will be created as a subpage of your user page.

    Step 3: Find a sponsor

    Your proposed article must be sponsored by an existing curator or editor of Scholarpedia. By sponsoring your article, a curator or editor publicly attests that

    1. the topic you propose is encyclopedic and worthy of a new Scholarpedia article, and
    2. you are a top world expert on this topic and/or the original inventor of this topic.

    One way to find a sponsor is as follows:

    1. Search through Scholarpedia's current encyclopedias at http://www.scholarpedia.org/article/Scholarpedia:Topics. Click on the link to the encyclopedia whose general topic most closely matches that of your proposed article.
    2. Search through the articles within that encyclopedia, and identify one whose topic is related to that of your proposed article. Click on the link to that article.
    3. In the upper right corner of the article page is the name of that article's curator. Click on that person's name, and you will arrive at his/her user page and find his/her email address.
    4. Open your article page, and click on the "Invite Sponsor" link on the top toolbar. You will be shown a URL. Copy the URL, and email it to the curator.

    An alternative way to find a sponsor (e.g., if you already have someone in mind and want to know whether that person is a Scholarpedia curator or editor) is to search through the lists of existing Scholarpedia curators (http://www.scholarpedia.org/article/Special:ListCurators) and editors (at http://www.scholarpedia.org/article/Main_Page, under "Active Editorial Board") and then follow steps 3 and 4 above.

    Once your article is sponsored, it is moved from your user page subpage to the main Scholarpedia namespace. If another article with the same title reached "Sponsored" status before yours and is currently in development, then your article will be placed in a queue of articles waiting to take the place of the one currently in development should it be rejected.

    Important: Once your article is sponsored, the deadline for getting the article written, reviewed, and approved is two months from the date when the article achieved "Sponsored" status.

    Step 4: Invite a co-author (optional)

    1. On your article page, click on the "Invite a co-author" button at the top left.
    2. You will then see an invitation link. Copy this link and email it to another expert on your article's topic.

    Step 5: Write the article

    Structure

    Scholarpedia articles do not contain an abstract, introduction, discussion, or conclusion section. However, most articles do share common structural elements. In general, each article should:

    • Start with a dictionary-like definition of the main topic (1 sentence to 1 paragraph long). This definition should be conceptually accessible to a broad audience of readers. For example:
      • "A neuronal burst of spikes is two or more action potentials followed by a period of quiescence."
      • "A dynamical system is a system whose state in any moment of time is a function of (1) its immediately previous state and (2) any input."
      • Note: Please use <strong> ... </strong> to bracket the mention of the article's topic in its definition, as this will improve its ranking in Google search results.
    • Progress from more basic to more advance concepts.
    • Make good use of bullet points, tables, and diagrams.
    • Be concise (2,000-4,000 words, not counting figure captions or references) but not terse.
    • Include the following sections at the end of the article:
      • “References” (== References ==): Keep the list of references to a minimum, ideally less than 20. Cite only major contributions, books, or review articles that are widely available. For reference style, see the "Style" subsection directly below this one.
      • “Recommended reading” (==Recommended reading==): Include major books that are not necessarily cited in the article.
      • “See also” (==See also==): Include links to relevant Scholarpedia articles. Also, go to those articles and add appropriate links to your article.
    • Also at the end of your article, include links to place your article in at least one category---for example, [[Category: Computational Neuroscience]] and/or [[Category: Dynamical Systems]].

    Style

    As entries in an encyclopedia, Scholarpedia articles should be written in "classic style" (as described in "Clear and Simple as the Truth" by Thomas & Turner, 1994, Princeton University Press).

    In general, when writing your article, you should follow these guidelines:

    • Format the text according to guidelines found here.
    • Avoid using first- and second-person (e.g., "I," "We," and "You").
    • Target the article to advanced undergraduate students studying in the article’s area and graduate students in related areas.
    • Anticipate and answer common questions a reader might ask about a topic (e.g., for an invention: who invented it, when, where, why, and how? What did the invention replace? What was its impact? Has it led to any notable successes or failures?). Notice that, e.g., Wikipedia articles are generally very successful in this regard.
    • Mention any and all widely accepted alternative perspectives on issues of controversy.
    • Explain only the terms unique to the article or not appropriately explained in other Scholarpedia articles. In all other cases, provide links to the appropriate Scholarpedia article. For instance, the article on Bursting does not explain concepts such as neurons, spikes, currents, and bifurcations, but instead links to other Scholarpedia articles for definitions of these terms.
    • Avoid using abbreviations.
    • For the references, use Harvard referencing style: "(Lastname et al. YEAR)” within the text of an article, and full citations in alphabetical order at the end. If you want to include a link to a reference in the text, type [[#mylabel|Lastname et al. YEAR]] in the text and put the label <span id="mylabel"></span> next to the reference. You can submit your references in BibTeX format or include them directly in your online article using Scholarpedia's Bibitem template. Please see Instructions for authors (Physics) for more information.

    Step 6: Invite peer reviewers

    When an article is ready for peer-review, press 'invite reviewer' on the dashboard. The article needs to be accepted by two existing Curators (an article Sponsor can also choose to serve as one of the article's reviewers).

    In general, it is the responsibility of the team of article authors to find reviewers for their article and to persuade these reviewers to approve the article for publication before the two-month deadline. If the article deadline lapses, it returns to the "proposed" (unsponsored) state and the process of sponsorship and review needs to be restarted.

    You may wish to direct the reviewers you invite to instructions for reviewers.

    Step 7: Revise the article

    Revise the article based on comments and suggestions from the reviewers.

    Step 8: Approve the article for publication

    After the article has been formally approved by two qualified reviewers, it will undergo a one-week cool-off period. During this period, editors of Scholarpedia have an opportunity to look over the article and ensure that it did not reach "published" status erroneously.

    1. After the cool-off period ends, one of the authors must approve the very first "official" version of the article for publication, by first clicking on the blue "Publish Article" button in the publication banner at the top of the article. (If this button is not enabled, the article may not have completed the cool-off period.)
    2. A pop-up will appear. The author should ensure that the order of the authors is correct within that pop-up and then select from the drop-down menu the author who will serve as the article's curator. The curator should be the most established expert on the article's topic, as it is this individual who will control the visibility of future revisions to an article.
    3. Click "Submit confirmation." The moment of final author approval is the time of official archival publication.
    Personal tools
    Namespaces

    Variants
    Actions
    Navigation
    Focal areas
    Activity
    Tools