Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: updated documentation to segregate sections for docker and binary #66

Merged
merged 2 commits into from
Feb 8, 2024

Conversation

PranshuSrivastava
Copy link
Contributor

@PranshuSrivastava PranshuSrivastava commented Feb 6, 2024

Pull Request Template

Description

Updated the README to make the instructions clearer and segregate the sections for binary and docker.

Fixes #1416

Type of change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • Any dependent changes have been merged and published in downstream modules
  • I have checked my code and corrected any misspellings
  • I have tagged the reviewers in a comment below incase my pull request is ready for a review
  • I have signed the commit message to agree to Developer Certificate of Origin (DCO) (to certify that you wrote or otherwise have the right to submit your contribution to the project.) by adding "--signoff" to my git commit command.

Signed-off-by: Pranshu Srivastava <iampranshu24@gmail.com>

### For docker on Linux

keploy test -c "java -jar target/<name-of-your-jar>" --delay 10
Copy link
Member

Choose a reason for hiding this comment

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

isn't the name of the jar fixed since we know the application and we can give the command to make a jar with xyzzy name?

@@ -64,41 +72,27 @@ to
spring.datasource.url=jdbc:postgresql://localhost:5432/petclinic
```

## Run the backend with Keploy(binary)
## Recording the testcases with Keploy

```
keploy record -c "java -jar target/<name-of-your-jar>"
Copy link
Member

Choose a reason for hiding this comment

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

Specify the jar name since the application is definite

@@ -3,12 +3,18 @@
This is a petclinic app where you can record testcases and mocks by interacting with the UI, and then test them using Keploy.
This project has two parts - the frontend and backend, since Keploy is a backend testing platform, we need to start the backend part of the project
using Keploy and run the frontend as it is.
You can start the backend using Keploy in 2 ways:
- Using Keploy's binary.
Copy link
Member

Choose a reason for hiding this comment

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

These should be the hyperlink to the subsequent section

3. MVN version 3.6.3

Prerequisites For Docker:
Copy link
Member

Choose a reason for hiding this comment

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

Better to mention the pre-requisites in their own section tops


```
# Instructions For Starting Using Docker
Copy link
Member

Choose a reason for hiding this comment

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

There's no keploy setup here! User will be lost.

Either move keploy setup to common setup or mention in both sections.

@nehagup
Copy link
Member

nehagup commented Feb 8, 2024

@PranshuSrivastava merging this for now as I need this for a demo, please make the changes and open a new PR.

Signed-off-by: Neha Gupta <gneha21@yahoo.in>
@nehagup nehagup merged commit 148087d into main Feb 8, 2024
2 checks passed
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