Skip to content

docs: fix typos in Desin.md - #894

Open
holgpar wants to merge 1 commit into
cap-java:mainfrom
holgpar:holger/improveDocs
Open

holgpar wants to merge 1 commit into
cap-java:mainfrom
holgpar:holger/improveDocs

Conversation

@holgpar

@holgpar holgpar commented Oct 2, 2026 •

Copy link
Copy Markdown

Improve Design Documentation Wording and Grammar

Documentation

📝 Updated doc/Design.md to improve readability, grammar, punctuation, and terminology consistency across the attachment feature design documentation. This is a documentation-only change with no impact on runtime behavior.

Changes

  • doc/Design.md: Fixed typos and grammar issues throughout the CDS model, handler, draft handling, delete flow, multi-tenancy, default service implementation, malware scan, and tests sections.
  • doc/Design.md: Standardized wording for terms such as “delete event”, “create event”, “content ID”, “event context”, and “top-level entity”.
  • doc/Design.md: Improved sentence structure and punctuation to make technical explanations clearer and easier to follow.
  • 🔄 Regenerate and Update Summary
PR Bot Information

Version: 1.31.69

  • LLM: gpt-5.5
  • Event Trigger: pull_request.opened
  • File Content Strategy: Full file content
  • Correlation ID: 90b1edf0-be5a-11f1-89e0-e3e9cdae0eb0
  • Summary Prompt: Default Prompt
  • Output Template: Default Template

@holgpar
holgpar requested a review from a team as a code owner October 2, 2026 12:12
@hyperspace-pr-bot

Copy link
Copy Markdown
Contributor

👋 Hi — I'm PR Bot, your SAP code review assistant.

I'll automatically review your pull requests for code quality, security, and SAP compliance. Get an overview of what I do →

What I do

  • Summarize your pull request changes
  • Review code for quality, correctness, and reliability
  • Suggest fixes when a pipeline job fails

Key commands

Command Description
/review [--all] Trigger a code review. Add --all to include files excluded by excluded_paths.
/summarize Generate a PR summary
/ask <question> Ask about the current changes
/help See all available commands

*This introduction message will be shown to you only once, you will not see it in future PRs.

@hyperspace-pr-bot hyperspace-pr-bot Bot 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.

The typo cleanup is generally focused, but two edits introduced misleading documentation around the actual class name and malware-scan update behavior. Addressing the inline comments should keep the design document aligned with the implementation.

PR Bot Information

Version: 1.31.69

  • LLM: gpt-5.6-sol
  • Event Trigger: pull_request.opened
  • Agent Instructions:
  • Experiment Variant: treatment
  • File Content Strategy: Full file content
  • Correlation ID: 90b1edf0-be5a-11f1-89e0-e3e9cdae0eb0

Comment thread doc/Design.md

Because the default implementation of the service stores the attachments in the database the `DefaultAttachmentService`
do nothing with the content of the attachment.
Because the default implementation of the service stores the attachments in the database, the `DefaultAttachmentService`

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.

[Naming]: The documented class name does not exist

The implementation is named DefaultAttachmentsServiceHandler, so the current name makes the class difficult to locate and is inconsistent with the actual handler. Consider using the concrete class name here.

Suggested change
Because the default implementation of the service stores the attachments in the database, the `DefaultAttachmentService`
Because the default implementation of the service stores the attachments in the database, the `DefaultAttachmentsServiceHandler`

Double-check suggestion before committing. Edit this comment for amendments.


Please provide feedback on the review comment by checking the appropriate box:

  • 🌟 Awesome comment, a human might have missed that.
  • ✅ Helpful comment
  • 🤷 Neutral
  • ❌ This comment is not helpful

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

This is not related to my change. I will improve consistency in another commit.

Comment thread doc/Design.md
After the client returns the `MalwareScanResultStatus`, this status is mapped to the possible status values defined in
the data model.
With this, the attachment entity is tried to be updated.
With this, the attachment entity is updated.

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.

[Clarity]: This now guarantees an update that may not occur

The scanner executes an update, but the operation can affect zero rows when an attachment moves between draft and active tables, as the following section describes. Consider retaining wording that makes this an attempted update rather than a guaranteed one.

Suggested change
With this, the attachment entity is updated.
With this, an update of the attachment entity is attempted.

Double-check suggestion before committing. Edit this comment for amendments.


Please provide feedback on the review comment by checking the appropriate box:

  • 🌟 Awesome comment, a human might have missed that.
  • ✅ Helpful comment
  • 🤷 Neutral
  • ❌ This comment is not helpful

@holgpar
holgpar requested a review from tomk8r October 2, 2026 12:26

@tomk8r tomk8r left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

thanks.
Minor nit: There is still a mix of hyphenated and non-hyphenated forms, e.g. delete-event vs. delete event. We can fix later.

Comment thread doc/Design.md
Comment on lines +462 to +463
The method in the `ApplicationService` handler to process the data runs at a later point in time to make sure
that validations done for the data are executed.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Suggested change
The method in the `ApplicationService` handler to process the data runs at a later point in time to make sure
that validations done for the data are executed.
The method in the `ApplicationService` handler that processes the data runs at a later point to ensure that all validations are executed first

This branch has not been deployed

No deployments
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.

2 participants