You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
are severely out-of-date (using a preview version of 2.0.0)
can host both F# and C# content
There is understandably quite some confusion about this (see #353 and #356), with users coming from the official docs reporting issues that are long fixed in recent versions. In addition to that, providing high-quality C# docs is hard with fsdocs, which mainly focuses on creating F# content with F# tooling.
Since official docs most likely have way better SEO than the internal one, this problem will only increase with time, meaning we should move to only hosting the official docs.
So the following should be done imo:
change the doc build pipeline to use content in this repo instead of https://github.com/plotly/plotly.net-docs, since i do not want to maintain two separate repos for this. Python , JS, and R versions of plotly do it that way as well.
use the api docs output from fsdocs, similarily to what the python lib is doing
ditch fsdocs for the tutorials in favor of the official docs build pipeline.
The text was updated successfully, but these errors were encountered:
Currently, there are 2 sets of docs for this library:
docs hosted on https://plotly.net, which i will call internal in this issue:
fsdocs
.fsx
files and api docs created by fsdocs via assembly inspectiondocs hosted on https://plotly.com/fsharp and https://plotly.com/csharp , which i will call official in this issue
There is understandably quite some confusion about this (see #353 and #356), with users coming from the official docs reporting issues that are long fixed in recent versions. In addition to that, providing high-quality C# docs is hard with fsdocs, which mainly focuses on creating F# content with F# tooling.
Since official docs most likely have way better SEO than the internal one, this problem will only increase with time, meaning we should move to only hosting the official docs.
So the following should be done imo:
The text was updated successfully, but these errors were encountered: