Skip to content

Comments

Adding and expanding alt text for figures in episodes in section 5#502

Open
matt-graham wants to merge 6 commits intomainfrom
issue-501
Open

Adding and expanding alt text for figures in episodes in section 5#502
matt-graham wants to merge 6 commits intomainfrom
issue-501

Conversation

@matt-graham
Copy link
Collaborator

Resolves #501

In some cases figures here already have alt-text attributes set but they are fairly minimal and not sufficient to convey same information as included in image so I have tried to expand these to be more descriptive.

@github-actions
Copy link

github-actions bot commented Dec 23, 2025

Thank you!

Thank you for your pull request 😃

🤖 This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}.

If you have files that automatically render output (e.g. R Markdown), then you should check for the following:

  • 🎯 correct output
  • 🖼️ correct figures
  • ❓ new warnings
  • ‼️ new errors

Rendered Changes

🔍 Inspect the changes: https://github.com/carpentries-incubator/python-intermediate-development/compare/md-outputs..md-outputs-PR-502

The following changes were observed in the rendered markdown documents:

 50-section5-intro.md               |  5 ++++-
 51-managing-software.md            | 22 +++++++++++-----------
 53-improvement-through-feedback.md |  8 ++++----
 md5sum.txt                         |  6 +++---
 4 files changed, 22 insertions(+), 19 deletions(-)
What does this mean?

If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible.

This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation.

⏱️ Updated at 2026-02-19 17:30:54 +0000

github-actions bot pushed a commit that referenced this pull request Dec 23, 2025
@bielsnohr bielsnohr requested a review from Devaraj-G January 27, 2026 10:46
@anenadic
Copy link
Collaborator

Also see #513 - where alt text was included in mermaid diagrams @matt-graham.

Copy link
Collaborator

@bielsnohr bielsnohr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall, this looks good to me. Just a few minor changes to make before merging.

Comment on lines +33 to +36
![Managing software](fig/section5-overview.svg){
alt='Flow chart showing five stages in software management lifecycle: 1. Setting up software environment; 2. Verifying software correctness; 3. Software development as a process; 4. Collaborative development for reuse; 5. Managing software over its lifetime - issue reporting & prioritisation, Agile development in sprints, software project management.'
.image-with-shadow width="1000px"
}
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As Aleks mentioned, this will get caught up in the Mermaid diagram changes, but since that will likely take some time to resolve, I would support getting this merged in to improve accessibility immediately, and then we deal with any conflicting changes in the Mermaid diagram PR #507

Co-authored-by: Matthew <6177028+bielsnohr@users.noreply.github.com>
github-actions bot pushed a commit that referenced this pull request Feb 19, 2026
github-actions bot pushed a commit that referenced this pull request Feb 19, 2026
github-actions bot pushed a commit that referenced this pull request Feb 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add descriptive alt-text for figures in episodes in section 5

3 participants