Skip to content

How we can improve the documentation for beginners #65

@simoninithomas

Description

@simoninithomas

📚 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: #64

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions