openapi: resolve the synthetic_size duplication

[koivunej]

We had accidentally left two endpoints for tenant: /synthetic_size and /size. Size had the more extensive description but has returned 404 since renaming. Remove the /size in favor of the working one and describe the text/html output.

[github-actions]

3024 tests run: 2891 passed, 0 failed, 133 skipped (full report)

---

Flaky tests (3)

Postgres 16

• test_gc_aggressive: release
• test_vm_bit_clear_on_heap_lock: debug

Postgres 15

• test_pageserver_small_inmemory_layers[True]: debug

Code coverage* (full report)

• functions: 31.6% (6336 of 20063 functions)
• lines: 47.4% (47660 of 100645 lines)

* collected from Rust tests only

---

_{The comment gets automatically updated with the latest test results
6aa1323 at 2024-05-08T12:50:44.318Z :recycle:}

[VladLazar]

Once this merges it would be good to update the cloud swagger spec and auto-generated client as well. Running make gogenerate in the cloud repo with the updated swagger did the trick last time (see https://github.com/neondatabase/cloud/pull/12340)

[koivunej]

Running make gogenerate in the cloud repo with the updated swagger did the trick last time (see neondatabase/cloud#12340)

I'll do it (or have someone do it) once I get the #7650 haggled (this week).

@duskpoet could you actually give this a quick round of review since I think you added the original /synthetic_size description but I forgot to tag you in? If you are delayed, I might merge this in but we'll still need to make sure the javascript rendering the SVG will not be broken by this change. Alternatively you can just reply if you know there's an automatic test against this openapi.yaml and where can I see it fail.

[duskpoet]

hey! nothing has changed in the structure, so I don't see how anything can break

if iam reading the diff correctly

[koivunej]

hey! nothing has changed in the structure, so I don't see how anything can break

if iam reading the diff correctly

Nothing in the JSON or SVG output changed, but the openapi description changed.