Skip to main content

Practical exercise

Instruction and application
In Progress

The InclusiveDocs challenge​

In this activity, you’ll step into the role of EcoSense’s documentation review team to refine an ML model report for clarity, inclusivity and stakeholder relevance, ensuring it communicates effectively across technical, regulatory and sustainability audiences.

These skills are essential for maintaining transparency and trust in ML projects. By practising inclusive documentation, clear communication and collaborative review, you’ll learn how to create reports that strengthen understanding, fairness and confidence across diverse teams and stakeholders.

Practical exercise context​

EcoSense Analytics is a sustainability intelligence firm using artificial intelligence to assess corporate climate risk exposure. Its climate risk assessment model helps investors evaluate physical risks (such as extreme weather) and transition risks (such as policy and market shifts) to support sustainable investment decisions.

As EcoSense prepares a climate risk model performance and insights report for internal risk committees and external regulators, several issues have surfaced. The executive summary doesn’t clearly connect technical results to business or environmental impact. Some sections are overly complex, and key areas such as fairness, explainability and governance need clearer treatment.Current situation

  • The data science team focuses on technical accuracy.
  • The sustainability team wants stronger links to environmental outcomes.
  • The compliance team needs clearer regulatory alignment.
  • Leadership expects a concise, inclusive report that builds stakeholder confidence.**As EcoSense’s documentation review team,**you will refine the climate risk model performance and insights report to improve clarity, inclusivity and stakeholder trust.

Download exercise resources​

Use the links below to download the climate risk model performance and insights report and theInclusiveDocs challenge template.

Work with your group to review the report and complete each step in the template as you revise and improve the documentation.

Optional: Download a copy of the workshop slides​

Optional: Download a copy of the workshop slides​

Activity instructions​

Work with your group to complete the following steps:

Review EcoSense's climate risk model report​

  • Review EcoSense's model report and note what stands out in tone, structure and clarity.
  • Consider which audiences — technical, regulatory or sustainability — might find it difficult to follow and why.

Edit the executive summary​

  • Rewrite the report summary (max 100 words) to highlight measurable business and environmental impact.
  • Focus on clear, inclusive language that connects technical insights to real-world value.

Identify documentation gaps​

  • Review the report and list missing, unclear or overly technical areas that could be improved.
  • Think about how a stronger structure or simpler explanations could make the document more useful for all readers.

Apply inclusive documentation principles​

  • Identify where language, tone or structure could unintentionally exclude or confuse audiences.
  • Propose practical fixes that enhance clarity, fairness and shared ownership across teams.

Summarise your updates​

  • Create a two-minute group presentation summarising how your updates improve the documentation.
  • Highlight what your team changed, how this improves understanding and why it builds stakeholder trust.

Regroup and share insights​

Return to the main session after 20 minutes to discuss key insights and recommendations.

Action item: Activity share-out​

  • What is one area where your group improved clarity or inclusivity in EcoSense’s documentation?
  • What change most strengthened stakeholder trust or understanding?
  • How did your group balance technical accuracy with accessibility for non-technical readers?