[ EPIC ] refactor docs using "Qiskit Patterns"

[javabster]

Tasks

Beta Give feedback

1. [ NEW PAGE ] What are Qiskit Patterns? #907
   content 📄 needs discussion 💬 on hold ⏸️ section: start +4
   
2. Replace "What is Qiskit" section #30
   content 📄 new ✨ on hold ⏸️ section: start +4
   

   
3. Patterns: script to migrate docs to new "guides" folder #1297
   infra 🏗️ +1
   
4. [ NEW PAGE ] Latest updates for "get started" section of guides tab #1301
   content 📄 +1
   

   
5. [ REFACTOR ] transpile/introduction page to remove workflow phrasing #910
   content 📄 +1
   
6. [ REFACTOR] verify/introduction to talk about "debugging" rather than the "verify" workflow step #925
   content 📄 needs discussion 💬 +2
   
7. Patterns: validate Patterns index pages include all guides #1299
   infra 🏗️ +1
   
8. Patterns: reduce annoyance for writers of having a flat folder? #1298
   infra 🏗️ needs discussion 💬 +2
9. Migration guides are rather hidden #903
   content 📄 needs discussion 💬 user feedback 📥 +3
   

   
10. [ REFACTOR ] run/introduction to reflect "run on hardware" pattern #924
    content 📄 on hold ⏸️ +2
    
11. [ EPIC ] Create/move pages for "Analyze Results" section #839
    4 of 5
    content 📄 epic 🏔️ +2
    
12. [REFACTOR] Build/Introduction to map pattern #908
    content 📄 on hold ⏸️ section: build 🧱 +3
13. [ EPIC ] Convert "Transpile" section to "Optimize for hardware" section #901
    4 of 4
    epic 🏔️ +1
14. [ REFACTOR ] start/intro page to discuss patterns format #906
    content 📄 on hold ⏸️ +2
15. [ EPIC ] Create new "Deploy" section #905
    0 of 3
    content 📄 epic 🏔️ infra 🏗️ +3
16. [ EPIC ] Redo docs overview page to reflect new patterns structure #927
    1 of 2
    epic 🏔️ +1
17. [ EPIC ] Convert "Build" section to "Map problems to circuits" section #900
    2 of 2
    content 📄 epic 🏔️ infra 🏗️ +3
18. [ EPIC ] Convert "Run" section to "Run on hardware" section #902
    1 of 1
    content 📄 epic 🏔️ +2
19. update ibm.com/quantum/qiskit to replace code component with patterns

Update: May 2024

• after some back and forth we are going with a different direction for the patterns revamp
• instead we will have the same homepage as before, just with the primary boxes replaced with pattern step names
• instead of having multiple tabs for each pattern step, we will have a single tab called "Guides" that will include a mixture of tools and workflow steps

Existing Docs for reference:

some more in depth explanation of patterns: https://www.ibm.com/quantum/blog/qiskit-patterns

[Eric-Arellano]

I removed the infra label to keep our project tracker more organized. If we do end up creating new sections, let's open a dedicated infra ticket.

[Eric-Arellano]

All the content changes have been made and there is only a little infra work remaining, which is tracked in close source. Congrats!