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

104 make the readme shine before opening the repo #105

Merged
merged 18 commits into from
Jan 16, 2025

Conversation

RemiFabre
Copy link
Member

Tried some README improvements before publishing. Is this style OK?
Added a License, a description, a list of features, some visuals and a short example

@RemiFabre RemiFabre added the documentation Improvements or additions to documentation label Jan 13, 2025
@RemiFabre RemiFabre self-assigned this Jan 13, 2025
@RemiFabre RemiFabre linked an issue Jan 13, 2025 that may be closed by this pull request
@RemiFabre RemiFabre requested review from Drenayaz and removed request for FabienDanieau January 13, 2025 20:39
Copy link

github-actions bot commented Jan 13, 2025

☂️ Python Coverage

current status: ✅

Overall Coverage

Lines Covered Coverage Threshold Status
83 60 72% 0% 🟢

New Files

No new covered files...

Modified Files

No covered modified files...

updated for commit: 6452651 by action🐍

Copy link
Contributor

@FabienDanieau FabienDanieau left a comment

Choose a reason for hiding this comment

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

Some minor comments.

LICENSE Outdated
same "printed page" as the copyright notice for easier
identification within third-party archives.

Copyright [yyyy] [name of copyright owner]
Copy link
Contributor

Choose a reason for hiding this comment

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

2025 Pollen Robotics

Copy link
Contributor

Choose a reason for hiding this comment

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

this should be tracked by lfs

@@ -12,8 +54,29 @@ Use the following command to install:
```console
$ pip install -e .[dev]
Copy link
Contributor

Choose a reason for hiding this comment

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

pip install -e . provides

    numpy >= 1.24
    scipy == 1.8.0
    matplotlib == 3.5.1
    meshcat == 0.3.2
    types-protobuf == 5.27.0.20240626

Is everything needed for simply running the IK? For instance matplotlib seems to be used for plotting graph.
If relevant, you may want to add another optional requirements dependency (like [dev]). Typically in the docker image in production we just need the minimum to run the IK.

README.md Outdated
## Usage
Basic example of an inverse kinematics call. The input is a Pose of dimension 6, the output is the 7 joints of the arm:
```python
symbolic_ik = SymbolicIK(arm="l_arm")
Copy link
Contributor

Choose a reason for hiding this comment

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

import is missing
the new user is going to copy and paste this

Copy link
Member Author

Choose a reason for hiding this comment

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

Cleaning up imports, requirements and examples will be done by @Drenayaz

Thanks for the inputs Fabien!

@RemiFabre
Copy link
Member Author

Everything has been done, merging

@RemiFabre RemiFabre merged commit f99854d into develop Jan 16, 2025
5 checks passed
@RemiFabre RemiFabre deleted the 104-make-the-readme-shine-before-opening-the-repo branch January 16, 2025 14:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Make the README shine before opening the repo
3 participants