Skip to content

docs: rewrite dependency-graph.md in ASD-STE100 Simplified Technical English - #2039

Merged
elharo merged 6 commits into
masterfrom
docs-ste100-dependency-graph
Aug 5, 2026
Merged

docs: rewrite dependency-graph.md in ASD-STE100 Simplified Technical English#2039
elharo merged 6 commits into
masterfrom
docs-ste100-dependency-graph

Conversation

@elharo

@elharo elharo commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Rewrites src/site/markdown/dependency-graph.md in ASD-STE100 Simplified Technical English.

Changes

  • Classified the page as descriptive text (no reader instructions).
  • Split long sentences; every sentence is now at most 21 words.
  • Removed present perfect ("has undergone"), "-ing" verb forms, and the banned modals "would"/"may"/"might".
  • Replaced "handy", "one would need", "e.g."-style wording with approved phrasing ("can", "must").
  • Removed semicolons and rotated synonyms ("gives"/"provides" -> "provides", "handy" -> "useful").
  • Broke noun chains over three words ("m2e's dependency hierarchy view" -> "the dependency hierarchy view in m2e").
  • Preserved all code blocks, identifiers, product names, and the license header verbatim.

@gnodet gnodet left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Clean STE rewrite — all emphasis, code blocks, and identifiers preserved. No dropped hyperlinks (the original had none). Two minor items below.

This review was generated by an AI agent and may contain inaccuracies. Please verify all suggestions before applying.

Claude Code on behalf of Guillaume Nodet

Comment thread src/site/markdown/dependency-graph.md Outdated
Comment thread src/site/markdown/dependency-graph.md Outdated
elharo and others added 3 commits August 5, 2026 14:37
Co-authored-by: Guillaume Nodet <gnodet@gmail.com>
Co-authored-by: Guillaume Nodet <gnodet@gmail.com>
@elharo
elharo marked this pull request as draft August 5, 2026 14:38
@elharo
elharo marked this pull request as ready for review August 5, 2026 14:41

@gnodet gnodet left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Both suggestions applied — "Enable the configuration property..." now preserves the opt-in semantics while staying STE-compliant. Looks good.

This review was generated by an AI agent and may contain inaccuracies. Please verify all suggestions before applying.

Claude Code on behalf of Guillaume Nodet

@elharo
elharo merged commit d75f8f6 into master Aug 5, 2026
23 checks passed
@elharo
elharo deleted the docs-ste100-dependency-graph branch August 5, 2026 18:17
@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown

@elharo Please assign appropriate label to PR according to the type of change.

@github-actions github-actions Bot added this to the 2.0.22 milestone Aug 5, 2026
@elharo elharo added the documentation Improvements or additions to documentation label Aug 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants