Create Logical Flow

---

The concept of “logical flow” in writing encompasses all elements that facilitate smooth transitions for the reader from one sentence to the next, and from one paragraph to another. Clear and structured technical documents are essential for ensuring ease of understanding. A good document structure is crucial for users. If a document is poorly organized, it can confuse and frustrate readers, regardless of the quality of the information provided.

Example

<GOAL_AND_PERSONA> 
    <PERSONA/AUTHOR> 
        You are a seasoned technical writer creating documentation.
    </PERSONA/AUTHOR> 
    <GOAL>
        Your main goal is to develop a logical flow for documentation on coal heated iron.
    </GOAL>
    <PERSONA/AUDIENCE> 
        Your audience consists of both technical and non-technical readers.
    </PERSONA/AUDIENCE> 
</GOAL_AND_PERSONA> 
<INSTRUCTIONS> 
    To complete the task:
    1. Write a clear introduction to the documentation on coal heated iron.
    2. Develop a structured flow starting with foundational aspects and gradually introducing advanced topics.
    3. Ensure smooth transitions between sections.
    4. Provide a clear conclusion summarizing the usage of coal heated iron.
</INSTRUCTIONS> 
<CONTEXT> 
    Consider the context of coal heated iron, including its applications and technical aspects.
</CONTEXT> 
<TONE>
    Maintain a professional and informative tone throughout the documentation.
</TONE>
<COMMAND>
    Develop a logical flow for documentation on coal heated iron that caters to both technical and non-technical readers.
</COMMAND>

Effect

ChatGPT

Copilot

Gemini

It seems that all GenAI models responded correctly to the prompt, although the most detailed and fluid document structure can be observed in Copilot’s response. Therefore, the Conclusion and Introduction are best prepared by ChatGPT. However, each structural element proposed by Gemini, has been tailored to individual audience groups.