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

Create readme #814

Open
wants to merge 7 commits into
base: release/4.0.0
Choose a base branch
from

Conversation

Assem-Uber
Copy link
Contributor

@Assem-Uber Assem-Uber commented Feb 11, 2025

Summary

Creating readme for v4 and change docker container default values to work with cadence composed docker

Changes

  • Update readme file with usage details
  • Update contribution guide
  • add a yaml file for composing backend services for local development
  • remove unuseddocker-compose.prod.yml

@Assem-Uber Assem-Uber marked this pull request as draft February 11, 2025 08:34
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved

#### Developing cadence-web against cadence composed docker

To start development against a dockerized cadence services, run the following command from the root of the project
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
To start development against a dockerized cadence services, run the following command from the root of the project
To start development against a dockerized cadence server, run the following command from the root of the project

@@ -0,0 +1,89 @@
# modified version of https://github.com/cadence-workflow/cadence/blob/master/docker/docker-compose-es-v7.yml
Copy link
Member

Choose a reason for hiding this comment

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

You could mention what the exact modifications are


## Deploy on Vercel
## Licence
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
## Licence
## License

nit


To learn more about Next.js, take a look at the following resources:
`build`: `Generates production builds`
Copy link
Member

Choose a reason for hiding this comment

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

The line breaks are not being rendered correctly here. You could use a table if that is easier


### Using cadence-web

Latest version of `cadence-web` is included in `cadence` composed docker containers that can be found [here][cadence]. To start using it clone `cadence` repo and run the following command
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Latest version of `cadence-web` is included in `cadence` composed docker containers that can be found [here][cadence]. To start using it clone `cadence` repo and run the following command
The latest version of `cadence-web` is included in the `cadence` composed docker containers in the [main Cadence repository][cadence]. Follow the instructions there to get started.

You can remove the docker-compose command here as well, users can follow the server repo readme for this.


To learn more about Next.js, take a look at the following resources:
`build`: `Generates production builds`
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
`build`: `Generates production builds`
`build`: `Generate a production build`

nit

`build`: `Generates production builds`
`start`: `Starts a production build`
`dev`: `Run development server`
`install-idl`: `Downloads idl files required for building/running the project`
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
`install-idl`: `Downloads idl files required for building/running the project`
`install-idl`: `Download idl files required for building/running the project`

nit


[![Build Status](https://github.com/uber/cadence-web/actions/workflows/build.yml/badge.svg)](https://github.com/uber/cadence-web/actions/workflows/build.yml) [![Docker Status](https://github.com/uber/cadence-web/actions/workflows/docker_publish.yml/badge.svg)](https://hub.docker.com/r/ubercadence/web/tags)

Cadence is a distributed, scalable, durable, and highly available orchestration engine we developed at Uber Engineering to execute asynchronous long-running business logic in a scalable and resilient way.
Copy link
Member

Choose a reason for hiding this comment

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

You can have the link to Cadence here instead of in line 7.


#### Running development environment

To run development server, follow this steps:
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
To run development server, follow this steps:
To run the development server, follow these steps:

nit

```
npm install && npm run install-idl && npm run generate:idl
```
2. Run development server using
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
2. Run development server using
2. Run the development server using

nit

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