huggingface / simulate

🎢 Creating and sharing simulation environments for embodied and synthetic data research
https://huggingface.co/docs/simulate
Apache License 2.0
190 stars 13 forks source link

Review Documentation Readme.md #277

Open simoninithomas opened 2 years ago

simoninithomas commented 2 years ago

Hey there 👋 , so here the review of readme.md:

Feedback

1️⃣ image => Don’t forget to change it if the namespace change.

2️⃣ image ⇒ Once the scene is created, you can save and share it as a file. This is a gIFT file, aka a JSON file with associated resources.

You can also render the scene or do simulations using one of the backend rendering/simulation engines (at the moment Unity, Blender and Godot).

I would also add more details on the saving/sharing format is engine agnostic and using a graphic industry standard (I suppose you talk about gIFT)

3️⃣ image Wrong placement since it’s for contributing.

4️⃣ ModuleNotFoundError: No module named 'mypy_extensions’ when we install simulate. ⇒ Can we add it to the requirement list?

5️⃣ image I think something is missing there 🤔

6️⃣ Loading a scene from a local file or the hu is done with ⇒ The hu?

7️⃣ image Ok some problems in the code:

  1. I think the path is not correct for the first line
  2. Second push_to_hub: don’t hesitate to add a comment saying that they need to change the path. In RL class a lot of people say "I don't have permission to push to ThomasSimonini/LunarLander" so it's important to be clear 😄. ⇒ I would add scene.show() at the end of the code so that they can visualize by themselves the red cube.

The content after is good. The node system is well explained.

osanseviero commented 2 years ago

Very nice feedback :fire: Feel free to open PRs directly to fix some of these that have a clear fix :)

simoninithomas commented 2 years ago

Good idea, thanks I created a PR for 2-3-4-6 here: #279