Skip to content

Refactor Section 2: quality dimensions, indicators and tools - #42

Merged
vuillaut merged 3 commits into
mainfrom
refactor_sections
Oct 28, 2026
Merged

vuillaut merged 3 commits into
mainfrom
refactor_sections

Conversation

@vuillaut

Copy link
Copy Markdown
Contributor

Closes #40

This PR reorganises the section around dimensions, indicators and tools

  • Renamed Section 2 to "Quality Dimensions and Indicators for Research Software".

  • Moved the opening paragraph on software engineering vs. research contexts into §1.2.2 Research Software Quality.

  • Updated §1.1 so the list of parts of Section 2 includes Community (§2.5).

  • New intro to Section 2

  • Each section gets an "Examples of indicators and related tools" list.

  • Template fix (templates/everse.latex): Allows line breaks after underscores so long indicator IDs don't run past the margin.

@vuillaut
vuillaut requested a review from gperu October 22, 2026 11:57
@vuillaut
vuillaut marked this pull request as draft October 22, 2026 11:57
@vuillaut

Copy link
Copy Markdown
Contributor Author

One point left to do from the issue:

  • For each technical dimension, add "Good enough practices" and "Examples of tools and indicators"

@gperu gperu left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

The PR looks very good and addresses all the points we discussed in our call. The PR improves also the language (for example, removes 'pillars'). After merging this PR, I think that we can further improve the language.

@gperu

gperu commented Oct 28, 2026

Copy link
Copy Markdown
Collaborator

@vuillaut "Closes #40" will close #40 on merge, but the technical-dimensions item is still open. Shall we change it to "Part of #40" before merging, or would we rather open a new issue for that item?

@vuillaut
vuillaut marked this pull request as ready for review October 28, 2026 17:46
@vuillaut

Copy link
Copy Markdown
Contributor Author

I'll merge and open a new issue just for the technical dimensions. Thanks for the review.

@vuillaut
vuillaut merged commit ba81b9f into main Oct 28, 2026
3 checks passed
@vuillaut
vuillaut deleted the refactor_sections branch October 28, 2026 17:51
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.

Refactor section 2.1

2 participants