Template:MEBF/2022

From Wikiversity
(Redirected from Template:MEBF)
Jump to navigation Jump to search

Marking and feedback template for the book chapter exercise for the motivation and emotion unit. Designed to be transcluded on a chapter talk page.

Simple example

Simple example[edit source]

See also detailed example

<!-- Official feedback -->
{{MEBF/2022
|1=
<!-- Overall comments... -->
#
|2=
<!-- Overview comments... -->
# 
|3=
<!-- Theory – Depth comments... -->
# 
|4=
<!-- Theory – Breadth comments... -->
# 
|5=
<!-- Research – Key findings comments... -->
# 
|6=
<!-- Research – Critical thinking comments... -->
# 
|7=
<!-- Integration comments... -->
# 
|8=
<!-- Conclusion comments... -->
#
|9=
<!-- Written expression – Style comments... -->
#
|10=
<!-- Written expression – Learning features comments... -->
#
|11=
<!-- Social contribution comments... -->
#
}}
~~~~

gives

Book chapter review and feedback[edit source]

This chapter has been reviewed according to the marking criteria. Written feedback is provided below, plus there is a general feedback page. Please also check the chapter's page history to check for editing changes made whilst reviewing through the chapter. Chapter marks will be available via UCLearn along with social contribution marks and feedback. Keep an eye on Announcements.

Overall[edit source]

Overview[edit source]

Theory – Breadth[edit source]

Theory – Depth[edit source]

Research – Key findings[edit source]

Research – Critical thinking[edit source]

Integration[edit source]

Conclusion[edit source]

Written expression – Style[edit source]

Written expression – Learning features[edit source]

Social contribution[edit source]

-- Jtneill - Talk - c 09:47, 18 October 2022 (UTC)

Detailed example[edit source]

Example use of the template which includes some commonly provided feedback comments:

<!-- Official book chapter feedback -->
{{MEBF/2022
|1=
<!-- Overall comments... -->
# Overall, this is an excellent chapter. It successfully uses psychological theory and research to help address a practical, real-world phenomenon or problem.
# Overall, this is a very good chapter. It makes very good use of psychological theory and research to help address a  real-world phenomenon or problem.
# Overall, this is a reasonably good chapter. It makes good use of psychological theory and research to help address a real-world phenomenon or problem.
# Overall, this is a basic, but sufficient chapter
# Overall, this is an insufficient chapter
# I suspect that the [[Motivation and emotion/Assessment#Assessment items|recommended 5 topic development hours and 45 book chapter hours]] were not invested in preparing this chapter. 
# Insufficient use of primary, peer-reviewed sources as citations
# Move non-peer reviewed links into the external links section
# Well under the [[Motivation and emotion/Assessment/Chapter#Word_count|maximum word count]], so there is room to expand
# Well over the [[Motivation and emotion/Assessment/Chapter#Word_count|maximum word count]]. The content beyond 4000 words has been ignored for marking purposes.
# This chapter "[[wikt:beat around the bush|beats around the bush]]" for ~* words (i.e., too much preamble) before starting to directly tackle the target topic in the section titled "*"
# The sub-title has been corrected to match the [[Motivation and emotion/Book/2022|index of topics]]
# Addressing the [[#Topic development feedback|topic development feedback]] could have helped to improve this chapter
# Obtaining (earlier) comments on a chapter plan via the [[Motivation and emotion/Assessment/Topic|topic development]] exercise could have helped to improve the chapter
# For additional feedback, see the following comments and [ these copyedits]
|2=
<!-- Overview comments... -->
# Well developed/Solid/Reasonably good/Basic/Underdeveloped Overview
# Clearly/Briefly explains the problem or phenomenon
# Explain the problem or phenomenon in more detail
# Too long. Move detailed content in subsequent sections. The purpose of the Overview is to briefly explain the topic, engage reader interest, and establish focus questions for the chapter.
# Engages reader interest by introducing a case study and/or example and/or using an image
# Consider introducing a case study or example or using an image to help engage reader interest
# Clear/Basic focus question(s)
# The focus questions could be improved by being more specific to the topic (i.e., the sub-title)
# Ideally, provide [[w:Open-ended question|open-ended]], rather than [[Closed-ended question|closed-ended]] focus questions
# Add focus questions in a feature box to help guide the reader and structure the chapter
|3=
<!-- Theory – Breadth comments... -->
# An excellent/very good range of relevant theories are selected, described, and explained
# Relevant theory is reasonably well explained
# Basic but sufficient coverage of relevant theory
# Insufficient use of relevant psychological theory about this topic
# The chapter doesn't wander off into discussion of irrelevant theory
# Overly focused on definitions; summarise and move to the more [[wikt:substantive|substantive]] aspects of theory
# Builds reasonably well on related chapters
# Builds somewhat on previous, related chapters
# Build more strongly on other related chapters (e.g., by embedding links to other chapters)
# Build more strongly on other *-related chapters (e.g., by embedding links to other chapters in this category: [[:Category:Motivation and emotion/Book/*]])
# There is too much general theoretical material. Instead, summarise and link to further information (such as other book chapters or Wikipedia articles), to allow this chapter to focus on the specific topic (i.e., the sub-title question).
|4=
<!-- Theory – Depth comments... -->
# Insightful/Very good/Reasonably good/Basic/Insufficient depth is provided about relevant theory(ies)
# Effective/Some/Basic/No use of tables and/or lists are to help clearly convey key theoretical information
# Excellent/Some/Basic/Insufficient use of examples to illustrate theoretical concepts
# One good use of an example to illustrate theoretical concepts. Consider using more.
# Place more emphasis on explaining the underlying theoretical constructs than methods of measurement
# Key citations are well used
# Lack of sufficient use of academic, peer-reviewed citations (e.g., see the {{fact}} tags)
# If you didn't consult an original source (e.g., ?), cite it as a [https://apastyle.apa.org/style-grammar-guidelines/citations/secondary-sources secondary source]
# The Reeve (2018) textbook is overused as a citation – instead, utilise primary, peer-reviewed sources
|5=
<!-- Research – Key findings comments... -->
# Excellent/Very good/Reasonably good/Basic/Insufficient review of relevant research
# More detail about key studies would be ideal
# Greater emphasis on effect sizes, major reviews, and/or meta-analyses would be helpful
# Lack of sufficient use of academic, peer-reviewed citations (e.g., see the {{fact}} tags)
|6=
<!-- Research – Critical thinking comments... -->
# Excellent/Very good/Good/Basic/Insufficient critical thinking about relevant research is evident
# Critical thinking about research could be further evidenced by:
## describing the methodology (e.g., sample, measures) in important studies
## discussing the direction of relationships
## considering the strength of relationships
## acknowledging limitations
## pointing out critiques/counterarguments
## suggesting ''specific'' directions for future research
# Claims are referenced
# Some/Many claims are unreferenced (e.g., see the {{fact}} tags)
|7=
<!-- Integration comments... -->
# Excellent/Very good/Reasonably good/Basic/Insufficient integration between theory and research
# The chapter places more emphasis on theory than on research
# Where research is discussed, it is integrated with theory
|8=
<!-- Conclusion comments... -->
# Excellent/Very good/Reasonably good/Basic summary and conclusion
# Insufficient as a cohesive summary of the best available psychological theory and research about the topic
# Remind the reader about the importance of the problem or phenomenon of interest
# Key points are well summarised
# Summarise key points
# Clear take-home message(s)
# Address the focus questions
# Add practical, take-home message(s)
|9=
<!-- Written expression – Style comments... -->
# Written expression
## Overall, the quality of written expression is excellent/very good/good/basic
## Overall, the quality of written expression is below professional standard. [https://www.canberra.edu.au/current-students/study-skills UC Study Skills] assistance is recommended to help improve writing skills
## Some of the written expression is quite abstract, which makes this a difficult read for an unfamiliar reader. Consider ways of simplifying the written expression to make it more accessible to a wider audience. This is the essence of [[w:science communication|science communication]].
## Use active (e.g., "this chapter explored") rather than passive voice (e.g., "this chapter has explored" or "this chapter will explore") [https://apastyle.apa.org/style-grammar-guidelines/grammar/active-passive-voice][https://www.grammarly.com/blog/active-vs-passive-voice/]
## Internationalise: Write for an international, rather than domestic, audience. [http://www.worldometers.info/world-population/australia-population/ Australians make up only 0.32% of the world human population].
## Some paragraphs are overly long. Communicate one key idea per paragraph in three to five sentences.
## Some sentences are overly long (unnecessarily wordy). Strive for the simplest expression of the point being made. At the very least, consider splitting longer sentences into two shorter sentences.
## Some sentences could be explained more clearly (e.g., see the {{explain}} and {{rewrite}} tags)
## The chapter could be improved by developing some of the bullet points into full paragraph format
## Avoid directional referencing (e.g., "As previously mentioned"). Instead:
### it is, most often, not needed at all, or
### use [[w:Help#Section linking|section linking]]
## Avoid one sentence paragraphs. Convey one idea per paragraph using three to five sentences.
## Use 3rd person perspective (e.g., "it") rather than 1st (e.g., "we") or 2nd person (e.g., "you") perspective[https://www.grammarly.com/blog/first-second-and-third-person/] in the main text, although 1st or 2nd person perspective can work well for case studies or feature boxes
## Avoid starting sentences with a citation unless the author is particularly pertinent. Instead, it is more interesting for the the content/key point to be communicated, with the citation included along the way or, more typically, in parentheses at the end of the sentence.
## Embed direct quotes within sentences and paragraphs, rather than presenting them holus-bolus. Even better, communicate the concept in your own words.
## "People" is often a better term than "individuals"
## Use gender-neutral language (e.g., mankind -> humankind, s/he -> they)
## Reduce use of [[w:weasel word|weasel word]]s which bulk out the text but don't enhance meaning
## Use permanent, rather than relative, time references. For example, instead of "20 years ago", refer to something like "at the beginning of the 21st century". In this way, the text will survive better into the future, without needing to be rewritten.
## Avoid overly emotive language (e.g,. *) in science-based communication
# Layout
## The chapter is well structured, with major sections using sub-sections
## Include an introductory paragraph before branching into the sub-sections (see {{expand}} tags)
## Avoid having sections with 1 sub-heading – use 0 or 2+ sub-headings
## Use the default heading style (e.g., remove additional bold)
## See earlier comments about [[#Heading casing|heading casing]]
## Provide more descriptive headings
# Grammar, spelling, and proofreading are excellent
# Grammar
## The grammar for some sentences could be improved (e.g., see the {{grammar}} tags)
### Grammar-checking tools are available in most internet browsers and word processing software packages.[https://www.google.com/search?q=grammar+checking+tools]
### Another option is to share draft work with peers and ask for their assistance.
## Check and make [https://www.grammarly.com/blog/comma/ correct use of commas]
## Check and correct use of possessive apostrophes (e.g., cats vs cat's vs cats')[https://grammar.yourdictionary.com/punctuation/apostrophe-rules.html]
## Use [[w:Serial comma|serial comma]]s[https://www.buzzfeed.com/adamdavis/the-oxford-comma-is-extremely-important-and-everyone-should] – they are part of APA style and are generally recommended by [[wikt:grammaticist|grammaticist]]s. See [https://www.youtube.com/watch?v=gBx8ooDupXY explanatory video] (1 min)
## Check and correct use of [https://www.google.com.au/search?q=grammar+that+vs+who that vs. who]
## Check and correct use of [https://www.google.com.au/search?q=affect+vs.+effect+grammar affect vs. effect]
## Check and correct use of [http://www.colonsemicolon.com/ semicolons (;) and colons (:)]
## Abbreviations
### Check and correct grammatical formatting for abbreviations (such as e.g., i.e., etc.)
### Only use abbreviations (such as e.g., i.e., et al., etc.) inside parentheses
### Use abbreviations sparingly. Do not use abbreviations for minor terms that aren't used very much in the chapter.
### Explain abbreviations (spell out) (e.g., HPA) when they are first introduced
### Once an abbreviation is established (e.g., PTSD), use it consistently. Don't set up an abbreviation and then not use it or only use it sometimes.
# Spelling
## Spelling can be improved (e.g., see the {{spelling}} tags). Spell-checking tools are available in most internet browsers and word processing software packages.
## Use [https://www.abc.net.au/education/learn-english/australian-vs-american-spelling/11244196 Australian spelling] (e.g., hypothesize vs. hypothesise; behavior vs. behaviour)
# Proofreading
## More proofreading is needed (e.g., fix punctuation and typographical errors) to bring the quality of written expression closer to a professional standard
## Remove unnecessary capitalisation
<!-- APA style -->
# APA style
## [https://apastyle.apa.org/style-grammar-guidelines/capitalization/diseases-disorders-therapies Use sentence casing for the names of disorders, therapies, theories, etc.]
## Use double (not single) quotation marks "to introduce a word or phrase used as an ironic comment, as slang, or as an invented or coined expression; use quotation marks only for the first occurrence of the word or phrase, not for subsequent occurrences" (APA 7th ed., 2020, p. 159)
## Write numbers under 10 using words (e.g., five). Express numbers 10 and over using numerals (e.g., 10).
## Direct quotes need page numbers – even better, write in your own words
## Replace double spaces with single spaces
<!-- Figures -->
## Figures
### Figures are very well captioned
### Provide more detailed Figure captions to help connect the figure to the text
### Figure captions use the correct format
### Use this format for figure captions: ''Figure X''. Descriptive caption in sentence casing. [[Motivation and emotion/Assessment/Chapter/Figures|See example]]
### Each Figure is referred to at least once within the main text
### Refer to each Figure at least once within the main text (e.g., see Figure 1)
### Refer to each Figure using APA style (e.g., do not use italics, check and correct capitalisation)
<!-- Tables -->
## Tables
### Table captions use APA style
### Use APA style for captions. [[Motivation and emotion/Assessment/Chapter/Tables|See example]]
### Each Table is referred to at least once within the main text using APA style
### Each Table is referred to at least once within the main text
### Refer to each Table using APA style (e.g., do not use italics, check and correct capitalisation)
### Refer to each Table at least once within the main text (e.g., see Table 1)
<!-- Citations -->
## Citations use correct APA style
## Citations are not in full APA style (7th ed.). For example:
### If there are three or more authors, cite the first author followed by et al., then year. For example, either:
#### in-text, Smith et al. (2020), or
#### in parentheses (Smith et al., 2020)
### Do not include author first name or initials
### Use ampersand (&) inside parentheses and "and" outside parentheses
### List multiple citations in alphabetical order by first author surname
### A full stop is needed after "et al" (i.e., "et al.") because it is an abbreviation of [[wikt:et alii|et alii]].
### Use a comma between the author(s) and year for citations in parentheses
### Select up to a maximum of three citations per point (i.e., avoid citing four or more citations to support a single point)
### Check and correct placement of full-stops
### Move non-peer-reviewed sources to the external links section
<!-- References -->
## References use correct APA style
## References are not in full APA style. For example:
### Check and correct use of capitalisation[https://apastyle.apa.org/style-grammar-guidelines/capitalization]
### Check and correct use of italicisation
### Separate page numbers using an en-dash (–) rather than a hyphen (-)
### Include hyperlinked dois
### "Retrieved from" is no longer used (APA style, 7th ed.)
### Add spaces between author initials
### Move non-peer-reviewed sources to the external links section
|10=
<!-- Written expression – Learning features comments... -->
# Excellent/Very good/Good/Basic/Insufficient use of learning features
# Excellent use of embedded in-text [[m:Help:Interwiki linking|interwiki links]] to Wikipedia articles
# Very good/Good/Basic/One use of embedded in-text [[m:Help:Interwiki linking|interwiki links]] to Wikipedia articles. Adding more interwiki links for the first mention of key words and technical concepts would make the text even more interactive. See [[Motivation and emotion/Book/2020/Nutrition and anxiety|example]].
# No use of embedded in-text [[m:Help:Interwiki linking|interwiki links]] to Wikipedia articles. Adding interwiki links for the first mention of key words and technical concepts would make the text more interactive. See [[Motivation and emotion/Book/2020/Nutrition and anxiety|example]].
# Excellent/Very good/Good/Basic/One/No use of embedded in-text links to related [[Motivation and emotion/Book|book chapters]]. Embedding in-text links to related book chapters helps to integrate this chapter into the broader book project.
# Use in-text [[m:Help:Interwiki linking|interwiki links]], rather than external links, per [[Motivation and emotion/Tutorials/Wiki editing|Tutorial 02]]
# Move links to non-peer-reviewed sources to the external links section
# Excellent/Very good/Good/Basic/No use of image(s)
# Excellent/Very good/Good/Basic/No use of table(s)
# Excellent/Very good/Good/Basic/No use of feature box(es)
# Excellent/Very good/Good/Basic/No use of quiz(zes)
# The quiz questions could be more effective as learning prompts by being embedded as single questions within each corresponding section rather than being presented as a set of questions at the end
# Excellent/Very good/Good/Basic/No use of case studies or examples
# Excellent/Very good/Good/Basic/No use of interwiki links in the "See also" section
## Use bullet points per [[Motivation and emotion/Tutorials/Wiki editing|Tutorial 02]]
## Rename links per [[Motivation and emotion/Tutorials/Wiki editing|Tutorial 02]]
## Also include links to related book chapters
## Also include links to related Wikipedia articles
## Use sentence casing
## Include sources in parentheses
## Move external links to the external link section
# Excellent/Very good/Good/Basic/No use of external links in the "External links" section
## Use bullet points per [[Motivation and emotion/Tutorials/Wiki editing|Tutorial 02]]
## Rename links per [[Motivation and emotion/Tutorials/Wiki editing|Tutorial 02]]
## Use sentence casing
## Include sources in parentheses
|11=
<!-- Social contribution comments... -->
# ~ logged, useful, minor/moderate/major social contributions with direct links to evidence
# Thanks very much for your extensive contributions
# ~ logged social contributions without [[Motivation and emotion/Assessment/Chapter#Making and summarising social contributions|direct links to evidence]], so unable to easily verify and assess
# Contributions made across three platforms
# Use a numbered list per [[Motivation and emotion/Tutorials/Wiki editing|Tutorial 02]]
# No logged social contributions
}}
~~~~

gives

Book chapter review and feedback[edit source]

This chapter has been reviewed according to the marking criteria. Written feedback is provided below, plus there is a general feedback page. Please also check the chapter's page history to check for editing changes made whilst reviewing through the chapter. Chapter marks will be available via UCLearn along with social contribution marks and feedback. Keep an eye on Announcements.

Overall[edit source]

  1. Overall, this is an excellent chapter. It successfully uses psychological theory and research to help address a practical, real-world phenomenon or problem.
  2. Overall, this is a very good chapter. It makes very good use of psychological theory and research to help address a real-world phenomenon or problem.
  3. Overall, this is a reasonably good chapter. It makes good use of psychological theory and research to help address a real-world phenomenon or problem.
  4. Overall, this is a basic, but sufficient chapter
  5. Overall, this is an insufficient chapter
  6. I suspect that the recommended 5 topic development hours and 45 book chapter hours were not invested in preparing this chapter.
  7. Insufficient use of primary, peer-reviewed sources as citations
  8. Move non-peer reviewed links to the external links section
  9. Well under the maximum word count, so there is room to expand
  10. Well over the maximum word count. The content beyond 4000 words has been ignored for marking purposes.
  11. This chapter "beats around the bush" for ~* words (i.e., too much preamble) before starting to directly tackle the target topic in the section titled "*"
  12. The sub-title has been corrected to match the index of topics
  13. Addressing the topic development feedback could have helped to improve this chapter.
  14. Obtaining (earlier) comments on a chapter plan via the topic development exercise could have helped to improve the chapter
  15. For additional feedback, see the following comments and [ these copyedits]

Overview[edit source]

  1. Well developed/Solid/Reasonably good/Basic/Underdeveloped Overview
  2. Clearly/Briefly explains the problem or phenomenon
  3. Explain the problem or phenomenon in more detail
  4. Engages reader interest by introducing a case study and/or example and/or using an image
  5. Too long. Move detailed content in subsequent sections. The purpose of the Overview is to briefly explain the topic, engage reader interest, and establish focus questions for the chapter.
  6. Consider introducing a case study or example or using an image to help engage reader interest
  7. Clear/Basic focus question(s)
  8. The focus questions could be improved by being more specific to the topic (i.e., the sub-title)
  9. Ideally, provide open-ended, rather than closed-ended focus questions
  10. Add focus questions in a feature box to help guide the reader and structure the chapter

Theory – Breadth[edit source]

  1. An excellent/very good range of relevant theories are selected, described, and explained
  2. Relevant theory is reasonably well explained
  3. Basic but sufficient coverage of relevant theory
  4. Insufficient use of relevant psychological theory about this topic
  5. The chapter doesn't wander off into discussion of irrelevant theory
  6. Overly focused on definitions; summarise and move to the more substantive aspects of theory
  7. Builds reasonably well on related chapters
  8. Builds somewhat on previous, related chapters
  9. Build more strongly on other related chapters (e.g., by embedding links to other chapters)
  10. Build more strongly on other *-related chapters (e.g., by embedding links to other chapters in this category: Category:Motivation and emotion/Book/*)
  11. There is too much general theoretical material. Instead, summarise and link to further information (such as other book chapters or Wikipedia articles), to allow this chapter to focus on the specific topic (i.e., the sub-title question).

Theory – Depth[edit source]

  1. Insightful/Very good/Reasonably good/Basic/Insufficient depth is provided about relevant theory(ies)
  2. Effective/Some/Basic/No use of tables and/or lists are to help clearly convey key theoretical information
  3. Excellent/Some/Basic/Insufficient use of examples to illustrate theoretical concepts
  4. One good use of an example to illustrate theoretical concepts. Consider using more.
  5. Place more emphasis on explaining the underlying theoretical constructs than methods of measurement
  6. Key citations are well used
  7. Lack of sufficient use of academic, peer-reviewed citations (e.g., see the [factual?] tags)
  8. If you didn't consult an original source (e.g., ?), cite it as a secondary source
  9. The Reeve (2018) textbook is overused as a citation – instead, utilise primary, peer-reviewed sources

Research – Key findings[edit source]

  1. Excellent/Very good/Reasonably good/Basic/Insufficient review of relevant research
  2. More detail about key studies would be ideal
  3. Insufficient use of relevant psychological research
  4. Greater emphasis on effect sizes, major reviews, and/or meta-analyses would be helpful
  5. Lack of sufficient use of academic, peer-reviewed citations (e.g., see the [factual?] tags)

Research – Critical thinking[edit source]

  1. Excellent/Very good/Good/Basic/Insufficient critical thinking about relevant research is evident
  2. Critical thinking about research could be further evidenced by:
    1. describing the methodology (e.g., sample, measures) in important studies
    2. discussing the direction of relationships
    3. considering the strength of relationships
    4. acknowledging limitations
    5. pointing out critiques/counterarguments
    6. suggesting specific directions for future research
  3. Claims are referenced
  4. Some/Many claims are unreferenced (e.g., see the [factual?] tags)

Integration[edit source]

  1. Excellent/Very good/Reasonably good/Basic/Insufficient integration between theory and research
  2. The chapter places more emphasis on theory than on research
  3. Where research is discussed, it is integrated with theory

Conclusion[edit source]

  1. Excellent/Very good/Reasonably good/Basic summary and conclusion
  2. Insufficient as a cohesive summary of the best available psychological theory and research about the topic
  3. Remind the reader about the importance of the problem or phenomenon of interest
  4. Key points are well summarised
  5. Summarise key points
  6. Clear take-home message(s)
  7. Address the focus questions
  8. Add practical, take-home message(s)

Written expression – Style[edit source]

  1. Written expression
    1. Overall, the quality of written expression is excellent/very good/good/basic
    2. Overall, the quality of written expression is below professional standard. UC Study Skills assistance is recommended to help improve writing skills
    3. Some of the written expression is quite abstract, which makes this a difficult read for an unfamiliar reader. Consider ways of simplifying the written expression to make it more accessible to a wider audience. This is the essence of science communication.
    4. Use active (e.g., "this chapter explored") rather than passive voice (e.g., "this chapter has explored" or "this chapter will explore") [1][2]
    5. Internationalise: Write for an international, rather than domestic, audience. Australians make up only 0.32% of the world human population.
    6. Some paragraphs are overly long. Communicate one key idea per paragraph in three to five sentences.
    7. Some sentences are overly long (unnecessarily wordy). Strive for the simplest expression of the point being made. At the very least, consider splitting longer sentences into two shorter sentences.
    8. Some sentences could be explained more clearly (e.g., see the [explain?] and [Rewrite to improve clarity] tags)
    9. The chapter could be improved by developing some of the bullet points into full paragraph format
    10. Avoid directional referencing (e.g., "As previously mentioned"). Instead:
      1. it is, most often, not needed at all, or
      2. use section linking
    11. Avoid one sentence paragraphs. Convey one idea per paragraph using three to five sentences.
    12. Use 3rd person perspective (e.g., "it") rather than 1st (e.g., "we") or 2nd person (e.g., "you") perspective[3] in the main text, although 1st or 2nd person perspective can work well for case studies or feature boxes
    13. Avoid starting sentences with a citation unless the author is particularly pertinent. Instead, it is more interesting for the the content/key point to be communicated, with the citation included along the way or, more typically, in parentheses at the end of the sentence.
    14. Embed direct quotes within sentences and paragraphs, rather than presenting them holus-bolus. Even better, communicate the concept in your own words..
    15. "People" is often a better term than "individuals"
    16. Use gender-neutral language (e.g., mankind -> humankind, s/he -> they)
    17. Reduce use of weasel words which bulk out the text but don't enhance meaning
    18. Use permanent, rather than relative, time references. For example, instead of "20 years ago", refer to something like "at the beginning of the 21st century". In this way, the text will survive better into the future, without needing to be rewritten.
    19. Avoid overly emotive language (e.g,. *) in science-based communication
  2. Layout
    1. The chapter is well structured, with major sections using sub-sections
    2. Include an introductory paragraph before branching into the sub-sections (see [Provide more detail] tags)
    3. Avoid having sections with 1 sub-heading – use 0 or 2+ sub-headings
    4. Use the default heading style (e.g., remove additional bold)
    5. See earlier comments about heading casing
    6. Provide more descriptive headings
  3. Grammar, spelling, and proofreading are excellent
  4. Grammar
    1. The grammar for some sentences could be improved (e.g., see the [grammar?] tags)
      1. Grammar-checking tools are available in most internet browsers and word processing software packages.[4]
      2. Another option is to share draft work with peers and ask for their assistance.
    2. Check and make correct use of commas
    3. Check and correct use of possessive apostrophes (e.g., cats vs cat's vs cats')[5]
    4. Use serial commas[6] – they are part of APA style and are generally recommended by grammaticists. See explanatory video (1 min)
    5. Check and correct use of that vs. who
    6. Check and correct use of affect vs. effect
    7. Check and correct use of semicolons (;) and colons (:)
    8. Abbreviations
      1. Check and correct grammatical formatting for abbreviations (such as e.g., i.e., etc.)
      2. Only use abbreviations (such as e.g., i.e., et al., etc.) inside parentheses
      3. Use abbreviations sparingly. Do not use abbreviations for minor terms that aren't used very much in the chapter.
      4. Explain abbreviations (spell out) (e.g., HPA) when they are first introduced
      5. Once an abbreviation is established (e.g., PTSD), use it consistently. Don't set up an abbreviation and then not use it or only use it sometimes.
  5. Spelling
    1. Spelling can be improved (e.g., see the [spelling?] tags). Spell-checking tools are available in most internet browsers and word processing software packages.
    2. Use Australian spelling (e.g., hypothesize vs. hypothesise; behavior vs. behaviour)
  6. Proofreading
    1. More proofreading is needed (e.g., fix punctuation and typographical errors) to bring the quality of written expression closer to a professional standard
    2. Remove unnecessary capitalisation
  7. APA style
    1. Use sentence casing for the names of disorders, therapies, theories, etc.
    2. Use double (not single) quotation marks "to introduce a word or phrase used as an ironic comment, as slang, or as an invented or coined expression; use quotation marks only for the first occurrence of the word or phrase, not for subsequent occurrences" (APA 7th ed., 2020, p. 159)
    3. Write numbers under 10 using words (e.g., five). Express numbers 10 and over using numerals (e.g., 10).
    4. Direct quotes need page numbers – even better, write in your own words
    5. Replace double spaces with single spaces
    6. Figures
      1. Figures are very well captioned
      2. Provide more detailed Figure captions to help connect the figure to the text
      3. Figure captions use the correct format
      4. Use this format for figure captions: Figure X. Descriptive caption in sentence casing. See example
      5. Each Figure is referred to at least once within the main text
      6. Refer to each Figure at least once within the main text (e.g., see Figure 1)
      7. Refer to each Figure using APA style (e.g., do not use italics, check and correct capitalisation)
    7. Tables
      1. Table captions use APA style
      2. Use APA style for captions. See example
      3. Each Table is referred to at least once within the main text using APA style
      4. Each Table is referred to at least once within the main text
      5. Refer to each Table using APA style (e.g., do not use italics, check and correct capitalisation)
      6. Refer to each Table at least once within the main text (e.g., see Table 1)
    8. Citations use correct APA style
    9. Citations are not in full APA style (7th ed.). For example:
      1. If there are three or more authors, cite the first author followed by et al., then year. For example, either:
        1. in-text, Smith et al. (2020), or
        2. in parentheses (Smith et al., 2020)
      2. Do not include author first name or initials
      3. Use ampersand (&) inside parentheses and "and" outside parentheses
      4. List multiple citations in alphabetical order by first author surname
      5. A full stop is needed after "et al" (i.e., "et al.") because it is an abbreviation of et alii.
      6. Use a comma between the author(s) and year for citations in parentheses
      7. Select up to a maximum of three citations per point (i.e., avoid citing four or more citations to support a single point)
      8. Check and correct placement of full-stops
      9. Move non-peer-reviewed sources to the external links section
    10. References use correct APA style
    11. References are not in full APA style. For example:
      1. Check and correct use of capitalisation[7]
      2. Check and correct use of italicisation
      3. Separate page numbers using an en-dash (–) rather than a hyphen (-)
      4. Include hyperlinked dois
      5. "Retrieved from" is no longer used (APA style, 7th ed.)
      6. Add spaces between author initials
      7. Move non-peer-reviewed sources to the external links section

Written expression – Learning features[edit source]

  1. Excellent/Very good/Good/Basic/Insufficient use of learning features
  2. Excellent use of embedded in-text interwiki links to Wikipedia articles
  3. Very good/Good/Basic/One use of embedded in-text interwiki links to Wikipedia articles. Adding more interwiki links for the first mention of key words and technical concepts would make the text even more interactive. See example.
  4. No use of embedded in-text interwiki links to Wikipedia articles. Adding interwiki links for the first mention of key words and technical concepts would make the text more interactive. See example.
  5. Excellent/Very good/Good/Basic/One/No use of embedded in-text links to related book chapters. Embedding in-text links to related book chapters helps to integrate this chapter into the broader book project.
  6. Use in-text interwiki links, rather than external links, per Tutorial 02
  7. Move links to non-peer-reviewed sources to the external links section
  8. Excellent/Very good/Good/Basic/No use of image(s)
  9. Excellent/Very good/Good/Basic/No use of table(s)
  10. Excellent/Very good/Good/Basic/No use of feature box(es)
  11. Excellent/Very good/Good/Basic/No use of quiz(zes)
  12. The quiz questions could be more effective as learning prompts by being embedded as single questions within each corresponding section rather than being presented as a set of questions at the end
  13. Excellent/Very good/Good/Basic/No use of case studies or examples
  14. Excellent/Very good/Good/Basic/No use of interwiki links in the "See also" section
    1. Use bullet points per Tutorial 02
    2. Rename links per Tutorial 02
    3. Also include links to related book chapters
    4. Also include links to related Wikipedia articles
    5. Use sentence casing
    6. Include sources in parentheses
    7. Move external links to the external link section
  15. Excellent/Very good/Good/Basic/No use of external links in the "External links" section
    1. Use bullet points per Tutorial 02
    2. Rename links per Tutorial 02
    3. Use sentence casing
    4. Include sources in parentheses

Social contribution[edit source]

  1. ~ logged, useful, minor/moderate/major social contributions with direct links to evidence
  2. Thanks very much for your extensive contributions
  3. ~ logged social contributions without direct links to evidence, so unable to easily verify and assess
  4. Contributions made across three platforms
  5. Use a numbered list per Tutorial 02
  6. No logged social contributions

-- Jtneill - Talk - c 09:47, 18 October 2022 (UTC)

See also[edit source]