Move Xopt docs to this repo

[pluflou]

This initializes the new repository for the Xopt docs site. The workflow in gh-pages.yml would be triggered by the pypi_upload.yml workflows when a new Xopt version is released, as well as when a push/merge is made to the main branch.

For this to be finalized:

• need to update the url in the settings to deploy to the Xopt docs site, ln 58 in the workflow file (right now it will deploy to the default github.io site which might be good for finalizing the development)
• need to update the secrets in the xopt-org/Xopt repo to add a token called "DEPLOY_DOCS" that authorizes the dispatch to this repo. The token needs to be fine-grain with read/write on the "Contents" permissions for this repo
• merge Remove docs files and add dispatch job Xopt#301 that removes the docs deployment workflow from the main repo and adds the dispatch job

[Copilot]

Pull Request Overview

This pull request moves the Xopt documentation into a dedicated repository and introduces a variety of example notebooks, API reference files, and continuous integration workflows for building and deploying the documentation.

• Adds multiple example notebooks covering Bayesian exploration, GP model creation, genetic algorithms, and basic generator usage.
• Introduces new API reference pages for major Xopt objects, including generators, evaluators, and VOCS.
• Configures GitHub Actions for building and deploying the documentation via MkDocs.

Reviewed Changes

Copilot reviewed 54 out of 54 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
docs/examples/multi_objective_bayes_opt/mggpo.ipynb	New multi-objective Bayesian optimization example notebook
docs/examples/gp_model_creation/model_creation.ipynb	New notebook for building GP models; minor markdown typo detected
docs/examples/ga/nsga2.ipynb	New notebook for NSGA-II generator with a few typographical issues
docs/examples/bayes_exp/*.ipynb	Additional notebooks demonstrating Bayesian exploration
docs/api/*	New API reference pages for Xopt modules and classes
.github/workflows/gh-pages.yml	CI/CD workflow for building and deploying the docs
README.md	Updated repository title and description