Skip to content

fix: readme#55

Draft
Kronprinz03 wants to merge 6 commits intomainfrom
fix-readme
Draft

fix: readme#55
Kronprinz03 wants to merge 6 commits intomainfrom
fix-readme

Conversation

@Kronprinz03
Copy link
Contributor

Have you...

  • Added relevant entry to the change log?

@hyperspace-insights
Copy link
Contributor

Summary

The following content is AI-generated and provides a summary of the pull request:


Improve and Restructure README Documentation

Documentation

📝 Comprehensive overhaul of the README.md to improve clarity, structure, and accuracy of the plugin documentation.

Changes

  • README.md: Major restructuring and content improvements across all sections:
    • Setup section: Renamed headings for clarity, fixed a typo ("aplication" → "application"), and updated install commands to use npm run i instead of npm install + npm i -g tsx.
    • Running the sample: Reorganized into separate "Using cds-tsx" and "Using cds watch" subsections, and added a new Troubleshooting subsection documenting npm run clean:* commands.
    • Developer usage: Expanded the SBPA binding section with proper CF login and bind commands, and added a new Importing Processes as a Service subsection explaining the import workflow.
    • Annotations section: Renamed headings to use proper casing (e.g., "Current annotation implementation" → "Annotations"), improved wording and grammar throughout, and capitalized examples/notes consistently.
    • Programmatic Approach: Completely reworked — split into Generic ProcessService and Imported Process Services (Typed) subsections, added a full service definition table, and expanded all code examples with clear inline comments.
    • Build-Time Validation: Renamed from "Current build time validation" to "Build-Time Validation".
    • Code examples: Replaced internal/specific process names (e.g., eu12.bpm-horizon-walkme...) with generic placeholder names (e.g., eu12.myorg.myproject.myProcess).
    • Minor fixes: Corrected punctuation, removed outdated/incomplete bullet points, and fixed the security policy link phrasing.

  • 🔄 Regenerate and Update Summary
  • ✏️ Insert as PR Description (deletes this comment)
  • 🗑️ Delete comment
PR Bot Information

Version: 1.19.1 | 📖 Documentation | 🚨 Create Incident | 💬 Feedback

  • Summary Prompt: Default Prompt
  • Correlation ID: 0d7b6410-26c1-11f1-8295-4ba65a303c23
  • LLM: anthropic--claude-4.6-sonnet
  • Event Trigger: pull_request.opened
  • Output Template: Default Template

💌 Have ideas or want to contribute? Create an issue and share your thoughts with us!
📑 Check out the documentation for more information.
📬 Subscribe to the Hyperspace PR Bot DL to get the latest announcements and pilot features!

Made with ❤️ by Hyperspace.

Copy link
Contributor

@hyperspace-insights hyperspace-insights bot left a comment

Choose a reason for hiding this comment

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

The README is a significant improvement overall, but there are four concrete defects that need fixing: a wrong npm command (npm run addnpm add), a broken CLI flag (-2--to), a syntactically invalid TypeScript code snippet in the generic ProcessService usage example, and a missing --no-copy flag in the remote import command that directly contradicts the warning text that follows it.

PR Bot Information

Version: 1.19.1 | 📖 Documentation | 🚨 Create Incident | 💬 Feedback

  • Event Trigger: pull_request.opened
  • LLM: anthropic--claude-4.6-sonnet
  • Correlation ID: 0d7b6410-26c1-11f1-8295-4ba65a303c23

README.md Outdated
Copy link
Contributor

Choose a reason for hiding this comment

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

do we still check this? should be removed I guess?

README.md Outdated
```

Valid status values are: `RUNNING`, `SUSPENDED`, `CANCELED`, `ERRONEOUS`, `COMPLETED`.
If no status filter is provided, all statuses except `CANCELED` are returned.
Copy link
Contributor

Choose a reason for hiding this comment

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

CANCELED -> CANCELLED

README.md Outdated
- The typed process service does not currently support local development.
- The process import is currently only possible via the command line.

# CAP - Process Plugin
Copy link
Contributor

Choose a reason for hiding this comment

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

put headline to top

README.md Outdated
```
npm install
npm i -g tsx
npm run i
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
npm run i
npm i

README.md Outdated
Comment on lines +38 to +41
`npm run clean:all` cleans all generated files and rebuilds them
`npm run clean:build` cleans the build files and rebuilds them
`npm run clean:types` cleans the generated cds-typer files and rebuilds them

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
`npm run clean:all` cleans all generated files and rebuilds them
`npm run clean:build` cleans the build files and rebuilds them
`npm run clean:types` cleans the generated cds-typer files and rebuilds them
- `npm run clean:all` cleans all generated files and rebuilds them
- `npm run clean:build` cleans the build files and rebuilds them
- `npm run clean:types` cleans the generated cds-typer files and rebuilds them

README.md Outdated
Comment on lines +31 to +33
npm run compile
cd tests/bookshop && npm run build
cd tests/bookshop && cds watch
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
npm run compile
cd tests/bookshop && npm run build
cd tests/bookshop && cds watch
npm run compile
cd tests/bookshop
npm run build
cds watch

README.md Outdated
```

If you want to have it as a cds instead of a csn you can add --as cds at the end. If you want to reimport the process use the --force flag at the end. The flag `no-copy` is very important, as otherwise the process will be saved locally on both `./workflows`and `./srv/external` folder which would result in cds runtime issues, as the json is not a valid csn model and cannot be stored in the `.srv/external` directory.
If you want the output as CDS instead of CSN, you can add `--as cds` at the end. To reimport the process, use the `--force` flag. The `--no-copy` flag is important, as otherwise the process definition will be saved to both `./workflows` and `./srv/external`, which would cause CDS runtime issues since the JSON is not a valid CSN model and cannot be stored in the `./srv/external` directory.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
If you want the output as CDS instead of CSN, you can add `--as cds` at the end. To reimport the process, use the `--force` flag. The `--no-copy` flag is important, as otherwise the process definition will be saved to both `./workflows` and `./srv/external`, which would cause CDS runtime issues since the JSON is not a valid CSN model and cannot be stored in the `./srv/external` directory.

@SirSimon04 SirSimon04 changed the title Fix readme fix: readme Mar 24, 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.

2 participants