📣 Updated Documentation - Looking for feedback

Hello everyone – :wave:

After a couple years of the same look & feel, I’m excited to share that the Dash Documentation is getting a makeover! Check it out at: https://dash.plot.ly

The first changes landed tonight:

  1. The visual style has been updated to match our new look (Read more: Plotly has a new look!)

  1. We added a nice new sidebar that shows the hierarchy of pages

  2. The sidebar is filterable and we’ve put some care into it:

    1. It’s focused by default when you open up the page. So, if you want to just quickly look up the properties for e.g. dcc.Dropdown, then you can 1) open https://dash.plot.ly, 2) Starting typing immediately (no need to use your mouse or cursor), 3) Press enter to view the top result. No mouse required! It’s very fast.
    2. We’ve indexed the sidebar so that you can search all of the component properties. For example, if you are trying to find an example of the property selected_row_ids, you’ll get this result:
      image
  3. There is a persistent page menu bar on the right hand side that shows the main sections of each documentation page.

  4. In many areas, the visual style is more readable: darker fonts with higher contrast and bolded text. In particular, you’ll notice it on the reference pages that show all of the properties for a given component:

We still have lots of work to do here and we’ll update the forum with our progress. In the coming weeks, we’ll be adding:

Is there anything else that you would like to see? Please let us know by commenting below. In the meantime, I hope that you enjoy the new look & the latest features.

I hope everyone is staying safe & healthy out there :heart:

Chris

5 Likes

I’m not a huge fan of PHP, but I love their community examples section. Everytime I have needed to do something, there is an example written by a member of the community that is close enough to what I am trying to do that I can figure it out with minimal effort and usually just a few modifications.

I find Python, Pandas, and Dash to be lacking in these areas. They will often have examples, but it will only cover 10% of the use cases, and so you need to guess about the correct syntax of what you’re trying to do and hope that it’s correct. This leads you through a trial and error process that takes time, and searching stack overflow for answers which is less than ideal. The community forum here is great and very responsive, but I shouldn’t need to search it for examples of what I’m trying to do; these should exist as part of the documentation itself.

I’d really like to see a community examples section, moderated by the Dash team, at least for their API reference section. I think it would help the Dash team as well, because you would better understand how you users are using your product, which will sometimes be in ways that you wouldn’t have thought of. You can review the top-rated workaround examples and put streamlining those as features on the roadmap for future Dash versions.

2 Likes

:partying_face: Wahoo!

Love the general overhaul.

Only comment is that some of styling is a little cramped. e.g.the code sometimes bleeds in to the text around it. Perhaps a little more spacing and use of background colours to clearly separate different types of information?

1 Like

Thanks for the feedback everyone! It is very much noted.

On content updates, we just published some new chapters on callbacks (notably clientside callbacks) - Feedback welcome here: Dash Callbacks documentation improvements (including clientside examples!)