cmap Documentation

Bokeh Team-

I find myself constantly referring to old plots to remember how use LinearColorMapper and LogColorMapper and realized I’ve been using them wrong. Well not wrong, but I was writing the DataSpec property when really you can use the _cmap functions and save some syntax.

Anyway, I decided the mappers should be documented along with the palettes so I have updated the “Styling Visual Attributes” page of the user guide to highlight them.

I was hoping I could get some feedback before opening a PR as this would be first contribution to the project.

I have attached a screenshot of the page on the local build and I can post the text here.

Thanks

Luke

Hi,

I think it would be great to add more docs about color mappers, you are correct that this has not gotten enough attention. I think your example and text is nice my only comments are :

* use "circle" rather than "scatter" It's not going away, but I don't really like to promote it either

* comma-first arg passing style is not used anywhere else, it would be better to match style with other examples

* do the values need to be sorted? Would be good to shorten/remove pandas dependence

* title can be passed directly to figure

Looking forward to your PR!

As an aside, I'd say it's always good just to make the PR first, BTW. The GitHub UI tools make it easier to make comments directly in the PR.

Thanks,

Sure.

Thanks for the comments. This is great. I will make these changes and post the PR for more review.

I'll admit I am trying to build up some expierence writing documentation so this is great for me.

Luke