doc: How to title x/y axis

[rzats]

What type of PR is this? (Check all that apply)

• 🛠 Refactor
• ✨ Feature
• 🐛 Bug Fix
• ⚡ Optimization
• 📝 Documentation Update

Description

In issue #2372, a user was confused about yaxis property usage in Taipy charts, confusing it for something like Matplotlib's plt.ylabel. In fact, their suggested "workaround" of using the layout property seems like the intended way to go about things :) This PR clarifies the documentation for xaxis and yaxis properties accordingly.

Related Tickets & Documents

• Closes [🐛 BUG] How to use the yaxis property of chart #2372.

How to reproduce the issue

N/A - just a documentation update.

Backporting

This change should be backported to:

• 3.0
• 3.1
• 4.0
• develop

Checklist

We encourage keeping the code coverage percentage at 80% or above.

• ✅ This solution meets the acceptance criteria of the related issue.
• 📝 The related issue checklist is completed.
• 🧪 This PR includes unit tests for the developed code.
  If not, explain why: documentation only
• 🔄 End-to-End tests have been added or updated.
  If not, explain why: documentation only
• 📚 The documentation has been updated, or a dedicated issue has been created.
  If not, explain why:
• 📌 The release notes have been updated.
  If not, explain why: handled by maintainers?

[arcanaxion]

Thanks for this PR. The descriptions for xaxis/yaxis is definitely ambiguous especially to someone not familiar with plotly internal workings (like myself), so I appreciate your added clarification.

The docs for Taipy chart already make many references to the Plotly JS docs, so I wonder if adding a reference to this https://plotly.com/javascript/reference/scatter/#scatter-xaxis (as opposed to this) would be helpful or clutter.

[rzats]

I've added this link to the docs - it should render roughly like this:

[FabienLelaquais]

I think that change is fair, and neat.
Now @rzats, @arcanaxion don't you think that we should add a little example of using this in the chart doc as well (viselements/charts/advanced)?
And if yes, can you think of a usecase that would demonstrate that? I suspect that you do have that example in your hands right now...

[arcanaxion]

don't you think that we should add a little example of using this in the chart doc as well (viselements/charts/advanced)?

This appears to address that: https://docs.taipy.io/en/develop/refmans/gui/viselements/generic/charts/basics/#adding-a-y-axis

I think we're good to merge this

[github-actions]

This PR has been labelled as "🥶Waiting for contributor" because it has been inactive for more than 14 days. If you would like to continue working on this PR, then please add new commit or another comment, otherwise this PR will be closed in 14 days. For more information please refer to the contributing guidelines.

[github-actions]

This PR has been labelled as "🥶Waiting for contributor" because it has been inactive for more than 14 days. If you would like to continue working on this PR, then please add new commit or another comment, otherwise this PR will be closed in 14 days. For more information please refer to the contributing guidelines.

[FredLL-Avaiga]

@rzats can you update your branch ?