[Wiki] NeurAnki by cmahlen

📖 AnkiHub Decks Wiki
11

NeurAnki Step Deck Submission Guidelines

Revision date: 3/14/2025

Try this tutorial to see how to submit suggestions (credit to the people at the AnKing Step Deck!) Make sure to follow the guidelines below!

You can also view others’ suggestions on AnkiHub’s website and like/dislike or comment.

:pushpin: Read This Before Suggesting

  • If your suggestions do not contain enough rationale and/or specific evidence, they will be automatically rejected
  • We also reserve the right to not provide an explanation if we deem your suggestion violates our guidelines found on this page.
  • By submitting a suggestion, you agree to adhere to these rules and follow them stringently, and you acknowledge that failure to follow these rules will result in automatic rejection
  • Remember, your suggestion can affect everyone on the deck

:vertical_traffic_light: Suggestion Rules

:white_check_mark: Follow These Rules Before Suggesting or It Will Result in Automatic Rejection

  • Always cite sources when making changes and use an acceptable source.
  • Do not copy/paste verbatim into the text/extra sections.

:magnifying_glass_tilted_left: Acceptable Sources:

  • Comprehensive Review in Clinical Neurology: A Multiple Choice Book for the Wards and Boards (2nd Edition) by Esteban Chen-Ching MD et al.
  • Continuum: Lifelong Learning in Neurology® by the American Academy of Neurology.
  • Society guidelines approved by AAN.
  • Comprehensive Review in Clinical Neurology: A Multiple Choice Book for the Wards and Boards 2nd Edition by Esteban Chen-Ching MD et al.
  • Continuum: Lifelong Learning in Neurology® by the American Academy of Neurology
    Suggestions reviewed per case basis since some review articles contain author opinions rather than generalized consensus
  • Society guidelines approved by AAN
  • Other cards in the deck (list specific nid #).

:prohibited: Unacceptable Sources:

  • Subspecialty consensus statements not approved by AAN.
  • First Aid, Pathoma, Boards & Beyond, Sketchy, Osmosis, Pixorize, AMBOSS.
  • NBME’s, UWorld
  • UpToDate, Medscape, Dynamed, or other quick reference resources.
  • Non-peer reviewed articles, Wikipedia, textbooks, school lectures.

:scroll: Provide a Sufficient Rationale

  • Your rationale should explain why this specific change should be added and/or why it would benefit users.
  • Give as much supporting information as possible and be as thorough as possible
  • Avoid ambiguous statements.
  • 1-3 word rationales are generally NOT accepted.

:cross_mark: Examples of Rejected Rationales:

  • “This might be tested” → provide source on a place it has been tested and provide enough reasoning why this should be added to the deck for everyone to benefit from
  • “This is nice to have” → provide more reasoning, it might be sufficient to add to your lecture notes field, why should it be added for all users? Explain further.
  • “URL of source” with no further explanation → A source with zero further explanation is usually rejected, please be extremely thorough

:framed_picture: Image Suggestions

  • Images must be formatted and cited appropriately.
  • If adding an image that is already in another note, specify the nid:### in your rationale.

:scroll: What Licenses Can I Use?

:white_check_mark: Accepted licenses:

  • CC BY, CC BY-SA, CC BY-ND, CC-NC, CC BY-NC, etc.

:cross_mark: Non-acceptable licenses:

  • If you see any of the following, that is an indicator that you probably cannot use that image
    1. ©
    2. Copyright
    3. Do not reproduce without permission
    4. All rights reserved

:writing_hand: Formatting Photo Credits

  • Change to italic and set font size to 10pt.
  • Two ways to format:
    1. Using the Wrapper Meta Add-on: Anki Add-on
    2. Using Extended Editor Add-on: Anki Add-on

:white_check_mark: Image Suggestion Checklist:

  • Image is added only to the extra or text sections.
  • Font size is 10.
  • Citation is italicized.
  • Format is JPEG/JPG (ideally).
  • Image width should be around 500-900px (max: 1500px).
  • Image size does not exceed 1MB (ideally under 500 KB).
  • Image is cited properly like how other cards are in the deck, in general follow this format → Photo credit: Author name (hyperlinked to website), Creative Commons/Public Domain Hyperlink, via website/journal name
  • Majority of websites have a copy/paste option for citations
    1. Wikimedia (copy/paste the attribution text)
    2. Can also use attribution-builder to help create citation

:books: Other Resources We Can Cite

Resources

:people_hugging: Help Us Review

  • Like/dislike others’ suggestions and leave comments!
  • Most maintainers joined the team due to consistent reviewing, commenting, and suggesting.

:label: Protect Personal Fields & Tags

All users should protect the following fields:

  • Lecture Notes
  • Missed Questions

If you have personal tags in your collection, please add them to the protected tags section.

:memo: Formatting Guidelines

:1234: One-By-One Notes

  • The cards need to be able to be recalled in order - this means that there needs to be a mnemonic or a sequence of treatment
  • The 5 P’s of pheochromocytoma can NOT be one-by-one because they all start with P and it will be impossible to do “ordered recall”
  • One by one notes should not be done for cards that have 2-3 clozes, unless they are mnemonics
  • To make a one-by-one note, set all the cloze deletions that you want to be hidden to the same number (e.g., c1). Then put some text in the “One by one” field (e.g., “y”).

image.png

:globe_showing_americas: Practice QID Tagging

  • Any QID tag additions/removals from Comprehensive Review in Clinical Neurology require a proper rationale.
  • Acceptable rationales include: Why this card will be helpful to answering the question AND/OR copy + paste from question directly to support addition/removal of tag
  • Unacceptable rationales include: “Fits QID”, “tags”
  • If tagging a card that contains information corresponding to an incorrect answer choice, please provide strong justification (e.g., these disease presentations are very similar)
  • This rule is to impose stricter guidelines on what does and what doesn’t fit to be tagged. Generally, tags for a QID should only be added if the card DIRECTLY helps you answer the question
  • This will decrease the amount of potentially unnecessary/unhelpful cards being tagged

:hammer_and_wrench: Submitting Major Content Changes

  • If making a major content change, include an explanation at the top of the extra section.
  • Add the current date in the format (M/YYYY), e.g., (May 2023).
  • Remove explanation after 1 year.

:framed_picture: Image Reveal Rules

  • If an image appears before the answer:
    • If the answer is text, show it above the image.
    • If the answer is another image, show it below the image.

:pencil: Cloze Deletions

  • For increase/decrease phrases, use hints:
    • Diabetes {{c1::increases::increases/decreases}} glucose
    • Otherwise, alphabetize the hint options: An action potential causes {{c1::de::de/hyper}}polarization of a neuron which is follwed by {{c1::hyper::de/hyper}}polarization.

:input_latin_uppercase: Period & Capitalization Rules

  • No periods at the end of cards unless 2+ consecutive sentences
    • If possible, try to avoid long sentences!
  • Capitals are only for proper nouns and the start of sentences.

:globe_showing_americas: Demographic Formatting

  • Per UTD, FA23, and the American Medical Association, we will keep capitalization when referring to White or Black populations. Online, there is a ton of variance however following the guidelines of the AMA, we have chosen to stick to capitalizing.

:magnifying_glass_tilted_left: Bolding, Underlining, and Italics

  • Bold main subjects.
  • Italicize less important details.
  • Use underlining sparingly.
  • Do not bold, underline, or italicize excessive amounts of text

:minus: Dashes in Extra

  • Use dashes (-) when listing multiple points in the Extra field.

:brain: Mnemonic Formatting

  • Bold the hint, underline the appropriate letter that is a part of the mnemonic.

:hospital: Disease Name Formatting

  • Bold the full disease name, keep abbreviation unbolded.

:bar_chart: Table Formatting

:wrench: Normal Table Formatting

Use this add-on: Table Editor Add-on.

:white_check_mark: UWorld Table Replacement

  • Replace images with formatted tables.
  • Bulk suggest changes for consistency.

:hospital: Algorithms

Two methods:

  1. Table Method (using Anki’s T5 editor).
  2. Algorithm Website.
  • Ensure algorithms are centered, formatted properly, and replace images.

:graduation_cap: Want to Become a NeurAnki Deck Maintainer?

We are looking for more maintainers!

To be considered:

  1. Consistent activity on AnkiHub at a minimum (liking, commenting, helping out etc.)
  2. Mostly accepted suggestions compared to rejected (>60-70%) relating to content/formatting-related changes (spelling, grammar, new content, formatting, etc.)
  3. Shows initiative to learn/understand/work with formatting/suggestion/rationale guidelines of the Neuranki deck (this document)
  4. Can contribute approximately minimum 1 hour a week to NeurAnki-related discussions/maintenance on AnkiHub
  5. Team player, respectful, helpful, and willing to learn, asks for help when needed

:envelope_with_arrow: If you meet the criteria, email neuanki.caleb@gmail.com.

Current maintainer team: @cmahlen , @dhruvinpandya4 , @Jon_Of_Arc , @Mihir_S

2 Likes