docs: 4x Examples are missing in navigation

[dangotbanned]

Description

I discovered this while working on generating them for packages/vgplot/spec-python/tests/test_examples (related #1075 (comment))

AFAICT, the nav is handwritten.
But one common thing between the 4 is that none have a meta.description field - so if it is generated - that is probably the issue.

region-tests.yaml got pretty close 😂

mosaic/specs/yaml/region-tests.yaml

Lines 1 to 4 in 7afc4ec

	meta:
	title: Region Interactor Tests
	descriptions: >
	Varied plots using region interactors to highlight selected values.

The other 3 omit meta entirely

Missing

• https://idl.uw.edu/mosaic/examples/line.html
• https://idl.uw.edu/mosaic/examples/crossfilter.html
• https://idl.uw.edu/mosaic/examples/region-tests.html
• https://idl.uw.edu/mosaic/examples/window-frame.html

[domoritz]

Maybe intentional? The line example is already in https://idl.uw.edu/mosaic/examples/. For cross filter, we have https://idl.uw.edu/mosaic/examples/flights-200k.html. And the other two are maybe more test examples.

[dangotbanned]

Maybe intentional?

Yeah I figured that might be the case!
At least region-tests.yaml looks like a typo though?

mosaic/packages/vgplot/spec/src/spec/Spec.ts

Lines 13 to 21 in 7afc4ec

	/** Specification metadata. */
	export interface Meta extends Record<string, any> {
	/** The specification title. */
	title?: string;
	/** A description of the specification content. */
	description?: string;
	/** Credits or other acknowledgements. */
	credit?: string;
	}

[domoritz]

Yeah, that looks like a typo. Maybe we can tell vscode to use the schema to validate the specs? But I don't recall whether meta is pirate of the spec.

[dangotbanned]

But I don't recall whether meta is part of the spec.

It is! That was the bit I linked to in (#1153 (comment))

The problem is that Meta has the equivalent to JSON Schema's {"additionalProperties": {"type": "object"}}.
So the typo is valid 🤔

[domoritz]

Ah, I see. We could try to type it since it's really only used in these examples but maybe we just fix the examples and move on for now.

[dangotbanned]

but maybe we just fix the examples and move on for now.

Yeah sounds good to me.
Were there any that you didn't want updated (RE: #1153 (comment))?

region-tests would be a quick fix. window-frame looks like the only other one that isn't covered by another example - but needs a title and description

[domoritz]

I'd say the line and crossfilter examples don't make sense. The first is already on the docs start page and the latter is redundant and a test. region-tests has test in the name so I'd like to hear from @jheer what he thinks. window-frame is a cool example. Could maybe use a slider to change the window but either way needs a proper title and description.