Changes

Before you write anything, ask yourself these questions to help you focus your message:

Before you write anything, ask yourself these questions to help you focus your message:

# For whom am I writing?

# For whom am I writing?

## The network is for anyone working as, with or supervising a data scientist. There are executives, HR, training, and other communities who are trying to support the use of data science in the public service without being data scientists themselves.

#* The network is for anyone working as, with or supervising a data scientist. There are executives, HR, training, and other communities who are trying to support the use of data science in the public service without being data scientists themselves.

## Write to the target audience. There will often be overlap between multiple groups in the target audience, but there is no need to target all subscribers with every article.

#* Write to the target audience. There will often be overlap between multiple groups in the target audience, but there is no need to target all subscribers with every article.

# What is the message I want to convey?

# What is the message I want to convey?

## What is the ‘take home’ message?

#* What is the ‘take home’ message?

## Make your point as early as possible, then reinforce it and expand throughout the article.

#* Make your point as early as possible, then reinforce it and expand throughout the article.

# How would I summarise the article?

# How would I summarise the article?

## The newsletter is only going to have a short description to be able to draw people towards your article.

#* The newsletter is only going to have a short description to be able to draw people towards your article.

## If you cannot summarise the post then it may need indicate a need to reduce the scope or focus the ideas.

#* If you cannot summarise the post then it may need indicate a need to reduce the scope or focus the ideas.

# Do readers need any special knowledge?

# Do readers need any special knowledge?

## Requiring special knowledge is fine, but it needs to be clear to readers if they are going to understand the topic.

#* Requiring special knowledge is fine, but it needs to be clear to readers if they are going to understand the topic.

## Rather than explaining some of the more basic concepts, link to materials that readers can use to get up to speed.

#* Rather than explaining some of the more basic concepts, link to materials that readers can use to get up to speed.

# What is this adding to the conversation?

# What is this adding to the conversation?

## The [https://www.tbs-sct.gc.ca/pol/doc-eng.aspx?id=25049 Values and Ethics Code for the Public Sector] plays a role in the decision to publish an article. If the article is repeating something that exists elsewhere, it is potentially a better use of time and money to highlight the external source rather than recreate an article.

#* The [https://www.tbs-sct.gc.ca/pol/doc-eng.aspx?id=25049 Values and Ethics Code for the Public Sector] plays a role in the decision to publish an article. If the article is repeating something that exists elsewhere, it is potentially a better use of time and money to highlight the external source rather than recreate an article.

== Article Types ==

== Article Types ==

Articles fall into different categories depending on their intent. While there is overlap between the different types of articles, it is important to be consistent in your approach and wording to provide a consistent experience.

Articles fall into different categories depending on their intent. While there is overlap between the different types of articles, it is important to be consistent in your approach and wording to provide a consistent experience.

Articles may be trying to explain a concept or series of steps. Ensure that your approach to the concept falls into a single quadrant from Figure 1 throughout the text, and does not confuse the reader as to your intent. Mixing different types of articles makes it harder for the reader to understand your intent, as it is unclear if you are trying to educate them or asking them to follow along in a series of steps.

 

Articles may be trying to explain a concept or series of steps. Ensure that your approach to the concept falls into a single article type throughout the text, and does not confuse the reader as to your intent. Mixing different types of articles makes it harder for the reader to understand your intent, as it is unclear if you are trying to educate them or asking them to follow along in a series of steps.