Based on successful 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.

<aside> 💡 Tip: Link to your other content

The body of the article presents an opportunity to guide your reader to your other content on Wevolver. There are two effective ways to achieve this:

You can do so in two ways:

1. Descriptive Anchor Text: Use descriptive and relevant anchor text within the body of your article to link to your other content on Wevolver. This approach helps readers understand the context of the linked content and encourages them to click through for more information.
2. Recommended/Further Reading: At the end of a section, you can include a line of text called "Recommended Reading" or "Further Reading" that guides the reader to other related content on Wevolver. This provides readers with a clear path to explore additional section related content that may interest them.

Example of Descriptive Anchor Text

Example of Further Reading

We recommend employing both of these strategies to maximize reader engagement and promote your content effectively on our platform. By doing so, you can create a cohesive and informative experience for your audience, encouraging them to explore more of your work on Wevolver.

</aside>

End