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

Update README: Add Installation and Setup Instructions #2135

Open
wants to merge 6 commits into
base: main
Choose a base branch
from

Conversation

Franlexa
Copy link

Overview

This PR updates the README file to include detailed installation and setup instructions for Maestro.

Details

  • Added a section on prerequisites (Java, Android SDK, Xcode).
  • Added instructions on cloning the repository and basic setup.

Related Issue

This PR addresses issue # by providing users with clear setup guidance.

Testing

  • Reviewed the README for clarity.
  • Checked links to ensure they direct users to relevant resources.

Additional Notes

Please review and provide feedback on the structure of the new sections.

… custom build logic to `build.gradle.kts` for creating JAR files.\n- Integrated publishing task for deployment readiness.\n- Enhanced compatibility with Java 1.8 using compiler options.
- Added detailed steps for building, packaging, and running the application.
- Included instructions for testing and publishing tasks using Gradle.
- Ensured clarity for contributors and users in README.
- Added detailed steps for building, packaging, and running the application.
- Included instructions for testing and publishing tasks using Gradle.
- Ensured clarity for contributors and users in README.
… custom build logic to `build.gradle.kts` for creating JAR files.\n- Integrated publishing task for deployment readiness.\n- Enhanced compatibility with Java 1.8 using compiler options.
- Added detailed steps for building, packaging, and running the application.
- Included instructions for testing and publishing tasks using Gradle.
- Ensured clarity for contributors and users in README.
Copy link
Contributor

@Fishbowler Fishbowler left a comment

Choose a reason for hiding this comment

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

Thanks for the contribution! Docs are always the unsexy bit that get neglected!

I've left a couple of questions/comments.

Copy link
Contributor

Choose a reason for hiding this comment

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

Should this binary be included?


To execute the application, run:

java -jar build/libs/maestro-0.1.0.jar
Copy link
Contributor

Choose a reason for hiding this comment

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

Why this route over the one that's in the maestro script in the root directory?

(Not saying this is wrong - I genuinely don't know which route has what tradeoffs)

Copy link
Author

Choose a reason for hiding this comment

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

Because it specifies including libraries and the version to run so that subsequently when there is an update the readme will be updated to which version is in vogue

Copy link
Contributor

Choose a reason for hiding this comment

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

But running the ./maestro script will build and run the current version of the code and not require the readme update, no?

Comment on lines +32 to +36
implementation("org.jetbrains.kotlin:kotlin-stdlib")
implementation("com.squareup.okhttp3:okhttp:4.9.2")
implementation("com.google.protobuf:protobuf-java:3.17.3")
testImplementation("org.jetbrains.kotlin:kotlin-test")
testImplementation("junit:junit:4.13.2")
Copy link
Contributor

Choose a reason for hiding this comment

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

This isn't my area of expertise, but from looking at other bits of code, I think there's a pattern of tracking dependencies via aliases to the toml.

Comment on lines +37 to +40

To run all tests, execute:

./gradlew test
Copy link
Contributor

Choose a reason for hiding this comment

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

Weirdly, I'm not certain that this actually does run all of the tests 😂

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