Update examples to have explicit names and tooltips

[zacdezgeo]

What I Changed

• Added some metadata to the examples
• Update how we generate the options to use the metadata file
• Use that metadata to generate the static HTML used in the playground.md file

Here's what the change looks like (tooltip not capture in screenshot, but it works!):

How to Test It

• Not sure if there's a test deployment, check that out if so
• Run uv run mkdocs serve

Other notes

• Closes Explicitly name examples to help users navigate where to start #71
• I tried a route where I would dynamically fetch the values of the csv, it was close but very cumbersome to retrieve the CQL content. Storing the CQL directly in the CSV was messy... I opted for the static code generation approach @bitner used. The CSV does require maintaining a very minimal amount of metadata on the examples. I think the extra effort is worth it.

[bitner]

Looks great, but I think that you forgot to include the cql_examples.csv

[zacdezgeo]

Should we keep it as is or try to implement some sort of search capability instead of the dropdown? It might be a future iteration.

[gadomski]

It might be a future iteration.

Yeah this PR seems like a good first step and we can get more dynamic down the road.

[bitner]

Hmmm, this only has the json examples. I think that we need to include the cql2 text examples as well. Maybe a first drop down that is just json/text and then the second drop down selects the example and we just swap out ".json" with ".txt"

[zacdezgeo]

@bitner; you mean in the CSV? It doesn't really impact functionality, but I can include them.

[zacdezgeo]

Added the txt paths to the csv. Used a quick one-off pandas script, not including in version control, but referencing here:

import pandas as pd

df = pd.read_csv('examples/cql_examples.csv', header=0, sep='|')
df['txt_path'] = df['path'].str.replace('.json', '.txt')
df['cql_path'] = df['path']
df.drop('path', axis=1, inplace=True)
df.to_csv('examples/cql_examples.csv', sep='|', index=False)

[zacdezgeo]

Got carried away before lunch; made the dropdown also a search box and the description of the current example gets added to the page as well.

[zacdezgeo]

Okok, I'm done FR now. I chatted with @alukach, who referenced that the best design for these types of converters is side-by-side dynamic conversion. Just working on getting edits to be possible on both sides: