trlx icon indicating copy to clipboard operation
trlx copied to clipboard

How we can improve the documentation for beginners

Open simoninithomas opened this issue 3 years ago • 6 comments
trafficstars

📚 The doc issue

Hey there 👋 I've done a first review of the documentation.

For context, I've skimmed the documentation as a beginner to see where are the friction points.

I've some solutions for some, that's why I opened a PR: #64

For others I prefer for now to open an issue to discuss with you on how we can improve it.

So here's the points:

  1. The documentation is clear and very well written. I think though we need to explain more how TRLX works in a nutshell. For instance, Leandro in TRL have a section where he made very good illustration to explain how it works https://github.com/lvwerra/trl/#how-it-works

image

  1. For the example page I was thinking on a readme explaining each different example (and update the website documentation)

  2. A simple colab as a quick starter can be interesting to have. For instance for SB3 integration we created a small one where in 10min you trained your first agent and load a PPO agent from the Hub to play Space Invaders. Having that kind of quick run colab can help people to rapidly get the big picture of the library.

  3. We miss a Bibtex for citing.

WDYT? 🤔

Suggest a potential alternative/fix

PR: https://github.com/CarperAI/trlx/pull/64

simoninithomas avatar Oct 24 '22 12:10 simoninithomas

Let's bring this up today during TRLX weekly :)

LouisCastricato avatar Oct 24 '22 13:10 LouisCastricato

@simoninithomas This looks great, as I mentioned in the TRLX weekly I'd love to help out creating quick-start colab notebooks. Do you have any vision in mind, or should I just give it a shot and put up a PR for review?

thedch avatar Oct 24 '22 17:10 thedch

@thedch I don't have for now a vision in mind. I was thinking on a quickstart with a simple model that we can train and test. If you have some ideas open a new PR so that we can exchange on it 🤗

simoninithomas avatar Oct 26 '22 05:10 simoninithomas

Is there any support group for trlx.. saw some comments for trlx weekly meeting?

promiseve avatar Dec 16 '22 15:12 promiseve

TRLX weekly is Monday at 1pm est in the discord. It's more of an engineering standup meeting than office hours. We've done office hours in the past though, let me know if this is something that interests you :)

LouisCastricato avatar Dec 16 '22 16:12 LouisCastricato

Good day Louis, Yes, please. How do I sign up for office hours?

promiseve avatar Dec 22 '22 13:12 promiseve