These are incomplete guidelines for contributing or improving articles on The Berean Archive.
Articles can be written in either html (with a little bit of php to help) or in Markdown, with the latter being the preferred format for new articles. Markdown files are
automatically converted to html on page load, via the
files in the root of the site. Typora is a decent and free editor for Markdown Files and supports most features used.
HTML tags can be embedded in the .md files to go beyond features supported by Markdown.
The HIV Evolution article is the most up-to-date example that conforms to this specification. Some other articles don't yet conform because they were written prior to this specification.
Except where it otherwise doesn't make sense to do so, most articles should use the following layout:
- Large image header
- Meta info: authors, created, modified, history
- Summary with short list of key points.
- Detailed Points 1..N
- Common Objections
- Issues and Unanswered Questions (if applicable)
- Further Reading
- Related Articles
More detailed sub-points can be summarized in one article with a link to a more detailed article. Likewise with large blocks of supplemental information.
- Make ample use of tables, lists, charts, and images to summarize information and to make article more readable.
- Within articles, use either citations inline or shortened versions of quotes. Include or link to full quotes in sources.
- NRSV should be the first choice for bible citations, since it is most commonly cited in academia.
Berean Modified MLA Rules
The main goal of citations is to make it easy to find and very sources. The Berean Modified MLA citation format is based on MLA version 8, with modifications are made to replace less helpful information with the more helpful:
- Website name and Publisher may be omitted if they are not significant.
- Access dates should be omitted for brevity.
- Since all journal articles names should be a link to their source, volume and issue numbers may be omitted.
- Words like Web and Print should be omitted--including page numbers indicates the source was originally in print.
- Long article names may be abbreviated, or subtitles omitted.
- Format dates as Feb 7, 2005 since it's more conventional.
Links and Pages:
- Any online content should have its title link to it source. If page numbers, or audio/video seek time can be linked, they should be linked instead.
- All longer audio and video sources should include the minutes and seconds, linked if possible. E.g. "At 2:23 " or "2:34 to 4:36 and 8:15 to 8:39"
- Page numbers should be preceded by the word "Page" or "Pages".
- Page numbers can be suffxed with a parenthetical note to find the specific place on the page. E.g. (2nd column, top left).
- Closed-source journal article titles should link to the most official source available, such as the journal's website or ncbi.nlm.nih.gov, even if the source only includes the abstract. If arXiv.org or someone else has a full source PDF published on their blog, it can be listed in the mirrors.
- "Ibid." should be replaced with list sub-items with a page number and at least some of the relevant text quoted.
- Journal names may use their approved abbreviations. This site can convert journal names to abbreviations.
- Citation notes are surrounded with <small>, which makes the text smaller and lighter.
- Since sites sometimes shut down, include mirror links in the comments, such as archive.org, archive.is, a screenshot of the source, or a local copy of the source in its entirity, if fair use allows it.
- Use two spaces after each period to improve readability.
Berean Modified MLA Examples
Here are several examples of what article citations should look like:
- Last, First. "Article Title". Webiste Name.
Comment about the source. Mirrors: Mirror 1 | Mirror 2 | Local copy with notes
- Behe, Michael J. "Design for Living." New York Times. Feb 7, 2005. Behe is a biochemist and a leading proponent of Intelligent Design. Mirrors: Archive.org | Local copy
- Last, First. "Paper Title." Journal Name, Year. Pages.
- Behe, Micahel J. "Experimental Evolution, Loss-of-function Mutations, and 'the First Rule of Adaptive Evolution'". Q Rev Biol 2010. Page 419 (top left). Mirrors: PDF on Behe's website | ResearchGate | FlipHtml5
"More than 40 species of African monkeys are infected with their own, species-specific, SIV and in at least some host species, the infection seems non-pathogenic." ↩
"Chimpanzees acquired from monkeys two distinct forms of SIVs that recombined to produce a virus with a unique genome structure." ↩
"We have found that SIV infection causes CD4+ T-cell depletion and increases mortality in wild chimpanzees, and so the origin of AIDS is more ancient than the origin of HIV-1." ↩
Forum, blog, or newsgroup comment:
Based on the guidelines here.
"Re: How come there's a Amoeba with 200 times larger gene set than humans?" Aug 27, 2016.
west_of_everywhere describes his/herself as "a grad student in Statistics in the Bickel group at UC Berkeley" who was part of the ENCODE Analysis Working Group. Mirrors: Local copy
Additional calculations without an external source:
Articles live in the
articles folder, which is organized by scholarly disciplein (biology, history, etc).