Based on succesfull content we've seen gain traction in the engineering community, we've created some guidelines on how to create great content that get's noticed.

Title & Subtitle

Title: Ideally use a narrative title that expresses your essential message, or the content of the article. Experiment with several variants to find one that really works. If you find it challenging to get a good title, defer it till after you have written the article because you might pick up ideas as you write, or ask a 3rd person for suggestions.

Subtitle: Summarise your article into one short sentence describing the main topic, goal, or outcome for the reader. Make sure the title and subtitle together tell the user why they should continue reading.

Start

Capture interest & tell what to expect:

This first paragraph should convey and summarize the significance of your article and should also be interesting enough to entice the readers to continue reading. You need to spark the interest of the reader, because humans internalize information better when their attention is focused. You also need to lay out what the reader can expect when reading the article. Summarize the structure and content. This helps during reading as it puts the information they receive in the context of the article. For example; “I’ll first explain why X happens, and then share examples.”

Body

Maintain focus.

Pay attention to information that may distract the reader from the main topic if added to the article. Be sure to stay focused on your topic when you write.

Maintain a logical flow.

Each paragraph should flow smoothly and logically to the next one. You can be explicit in describing how paragraphs relate to each other. For example, a sentence like “The following paragraph illustrates the principle described here.” Do not jump around from one issue to the next.

Keep paragraphs short.

Readers are generally drawn to relatively small sized paragraphs. Often 3 to 6 lines per paragraph can convey the essence of what you want to say

Provide trustworthy sources.

Make sure your information is credible. Verify facts, dates, numbers, statistics, names, and spellings. Cite sources of information that if it is key to your topic.

End

Summarize or conclude the article:

In the last paragraph summarize your main points and issues, or you draw a conclusion based on the information You can provide information on how readers can help or take action from the information in your article. You can also provide information on where to find further information, or what to read next to continue exploring your topic.