Revamp options page

[beckykd]

Closes #1416
Closes #1453
Closes #1247
Closes #1529

Comment from Blake: the discoverability of the detailed Sampler and Estimator options is very poor. i.e. a user can only find these by navigating the Qiskit Runtime IBM Client API docs. Can we add links to SamplerOptions and EstimatorOptions to the Get started with primitives page?

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[beckykd]

@arnaucasau or @frankharkins , I need to change the order of these files in the TOC in the entries.py page. Overview should be above error suppression. I assume you just move them around, but Eric said it's complicated so we should ask you. Could one of you please make whatever change is necessary?

This is what it looks like now:

    children=(
        Entry(
            "Configure error suppression",
            slug="/configure-error-suppression",
            from_file="run/configure-error-suppression.mdx",
        ),
        Entry(
            "Configure runtime error mitigation",
            slug="/configure-error-mitigation",
            from_file="run/configure-error-mitigation.mdx",
        ),
        Entry(
            "Qiskit Runtime options overview",
            slug="/runtime-options-overview",
            from_file="run/runtime-options-overview.mdx",

[arnaucasau]

Yes, in this case, we only need to change the order of the entries. I changed it in af0b867 and as you can see in the following screenshots, we get the correct order in the left ToC and in the index of the execute-on-hardware page. Let me know if I can help with something else :)

[javabster]

I got some feedback from the enablement team that they have been using this table in some of their workshops with users and it has been well received, do you think there is a way to incorporate this table (or something similar) into the options page?

[beckykd]

do you think there is a way to incorporate this table (or something similar) into the options page?

Since we're planning on putting in options for Estimator V1, V2 and Sampler V1, V2, it seems like the best thing to do would be to move that table into this topic (and add 3 more like it), rather than duplicating it. Thoughts?

Another question - in the current table, we have a description and code example too. I feel like that will get really long but I don't want to lose that information. I'll think about a solution.

[qiskit-bot]

Thanks for contributing to Qiskit documentation!

Before your PR can be merged, it will first need to pass continuous integration tests and be reviewed. Sometimes the review process can be slow, so please be patient. Thanks! 🙌

One or more of the following people are relevant to this code:

• @ElePT
• @abbycross
• @beckykd
• @jyu00
• @blakejohnson

[beckykd]

follow-up here: #1723