document the kafkaesque nightmare fugue-state that is working with shopify's api

[chase-moskal]

• it's impossible to run product queries inside a collection

  • we'll have to design sheep-cart's whole ui around this limitation
    • we'll have a mode where users can browse a collection's products
    • we'll have a search mode where users can type terms, and check-enable tags
    • but these have to be two separate viewing mode -- never both
  • in shepherd, we'll make:
    • shopify.products_in_collection({collection_id, must_be_available: true})
    • shopify.products({query: {terms, tags}})

• totalInventory and quantityAvailable are unreliable and often throw unsolvable scoping errors

[chase-moskal]

• as a merchant using shopify's ui, it's not possible to list which products you've accidentally left out of any collections, hah

[chase-moskal]

• holy moly, when you use shopify as a headless cms, it removes the "seo" editable section from your product pages, for no discernible reason, so you can't edit your product's handle (the url shortname that we'll need)
  • surely a bug or silly mistake on shopify's part, they seem to think the product handles could only ever possibly be used with their online store builder (which i believe activates the editable seo section which harbors the information that is still used by headless api users...)

[chase-moskal]

• good lord, shopify's productTags endpoint has a broken half-implementation of pagination
  • they provide the cursor pageInfo you would need for pagination...
  • ...but they fail to accept the after parameter.. so you can't start from anywhere but the first page
  • this will effectively limit us to 250 tags...