Jump to content

User:2020sEra/Style guide/KLHates Peer Review

From Wikipedia, the free encyclopedia

General info

[edit]
Whose work are you reviewing?

2020sEra

Link to draft you're reviewing
User:2020sEra/Style guide
Link to the current version of the article (if it exists)
Style guide

Evaluate the drafted changes

[edit]

Lead

[edit]

Hello!

The lead has not been edited, as far as I can tell. So, my comments will pertain to the original article, and please take my comments as suggestions/things to think about.

For the first paragraph, I appreciate the use of bolding and defining . I think the first reference could be improved from the Guardian, so I'd search for a peer reviewed, academic source defining what a style guide is. Here is an idea for a new reference: https://www.jstor.org/stable/26464421 The lead is a little too conversational for my liking, specifically sentences like "although that term also has multiple other meanings." Additionally, there are a lot of longer sentences. I think splicing some sentences to give the lead a bit more 'rhythm' would be helpful. Overall, the first paragraph effectively defines and clarifies what a style guide and many of the related terms like 'style sheet.'

I really like the second paragraph. It helps redirect people who are looking for something more specific, and it concisely informs the user of the many purposes of style guides. Imo, there is nothing that needs to be changed about the language. The only concern I have is the lack of references in this section, especially when there are broader statements being made like "For translations, a style guide may be used to enforce consistent grammar choices such as tenses, formality levels in tones, and localization decisions such as units of measurements." I'd browse JSTOR and other academic sources for references for this section.

The third paragraph is short, however there is a lot that could be improved. The first sentence is extremely long, and I think it could be broken into 2 or 3 sentences. It took me two re-reads to understand what that sentence was trying to communicate, so some copy editing is needed there. Here is an idea of how it could be changed, though even this could be more clear:

"Style guides are specialized for various uses and audiences. Style guides can be for general use of a broad public audience, or for students, scholars, and professionals of different academic disciplines, medicine, journalism, the law, government, business, and specific industries."

I like the definition of house style, however it needs a reference. Later in the article, it could be helpful to offer an example of a house style guide, or redirect to another wikipedia page with more information (if there is one).

Overall, there is a lot this lead does right. It is balanced and neutral, it helps narrow down the topics and focuses of the article, and it is well organized. However, there could be improvement by:

  • Incorporating more peer reviewed, diverse, academic references
  • Simplifying and splicing longer sentences for clarity and concision
  • If a topic is not redirected to a relevant Wikipedia article, ensure that it is included later in your article (e.g. house style).

I am excited to see your edits, great job!