Paired withplotly/plotly.js#7469 (formatting changes to JavaScript that Python docs are derived from).

• Move contents ofcommands.py to scripts in newbin directory and break
  into individual scripts.
  • Tidy up imports etc. while doing so.
• Move code generation from./codegen to./bin/codegen.
• Moveplot-schema.json to./resources rather than burying it under the
  codegen folder.
• AddMakefile to run commands instead of putting everything incommands.py.
  • Runruff directly for checking and formatting rather than launching a
    subprocess from Python ascommands.py did.
• Modify.gitignore to ignoredocsanddocs_tmp. (Will eventually want to includedocsor overwritedoc`.)
• Minor reformatting ofREADME.md.
• UpdateCONTRIBUTING.md to describe relocation of commands and code
  generation tobin.
  • CONTRIBUTING.md documents--local,--devrepo and--devbranch options
    for updating JavaScript bundle thatcommands.py didn't seem to provide.
• Addmkdocs.yml configuration file formkdocs.
  • Most of this file was vibe coded using Claude.
  • mkdocs does not support reading configuration frompyproject.toml, so
    we need the extra config file.
  • Usematerial theme.
  • Read hand-written Markdown frompages and write output todocs.
  • Generate module index pages on the fly usingmkdocs-gen-files plugin.
    (See discussion ofbin/generate_reference_pages.py below.)
  • Set docstring style togoogle (even though much of our documentation
    isn't formatted that way).
• Add placeholder Markdown files inpages that include files from the root
  directory (README, code of conduct, contributors' guide, license).
  • Remove relative links between these pages because they don't work when
    the content is transcluded one directory lower.
• Modify docstring inplotly/_subplots.py to escape closing] with backslash
  to avoid confusingmkdocs Markdown.
  • Here and elsewhere the escape is written\\] because we need\] in the
    actual string. We could convert the docstrings to literal strings prefixed
    withr to avoid the double backslash.
  • Have also escaped some[ as\\[ for the same reason.
• Similar change toplotly/basedatatypes.py.
• Reformat line breaks in docstrings inplotly/express/_core.py.
• Modifypyproject.toml to installmkdocs and related packages for dev.
• Modifypyproject.toml to installpydoclint for checking documentation.
  • Currently reporting alot of errors.
• Updateuv.lock to match.

To do:

• Movescripts/gen_ref_pages.py intocommands.py. (Can't do this becausemkdocs.yml only accepts the name of the script, not parameters.)
• Include content from docstrings in hand-written Python code.
• Include content from docstrings in generated Python code.
• Include navigation links in left nav bar.
• Clean up warnings produced bymkdocs.
• Add linting for docstring style.
• Clean up (many) errors reported bypydoclint.
• Re-introduce links between.md files in root directory (taken out because they don't resolve when those files are transcluded frompages/*.md).
• Fix\[ formatting glitch in the following files (caused by replacing][ with]\[ to avoid Markdown thinking it's a reference link, but the text is inside back quotes):
  • plotly/graph_objs/histogram2dcontour/_contours/index.html
  • plotly/graph_objs/contour/_contours/index.html
  • plotly/graph_objs/contourcarpet/_contours/index.html
  • plotly/graph_objs/table/_header/index.html
  • plotly/graph_objs/table/_cells/index.html