We will need to add missing API events that are used with subscribe and unsubscribe.

List of supported events:
https://github.com/gosling-lang/gosling.js/blob/dec0e6434c39c233cf7cc35fe96c21747f37fa95/src/core/gosling.schema.ts#L256

mouseOver: PointMouseEventData;
click: PointMouseEventData;
rangeSelect: RangeMouseEventData;
rawData: CommonEventData;

Example documentation in HiGlass: https://docs.higlass.io/javascript_api.html#public.on

We have several experimental options that can be useful for users already, such as

• Performant rendering (e.g., experimental.stretchGraphics)
• Mouse events (e.g., experimental.mouseEvents)

These would be useful to include in docs so that people are aware of these features. We can clarify that these are experimental by adding a note block, e.g.,

The section of the home page of gosling-lang.org with example graphics that you can click on which will take you to the editor is hard to navigate with keyboard, because you first get all links and names, and then a set of unnamed buttons (which you can click on with mouse). Perhaps restructure this such that the HTML elements are ordered as button-link+desc-button-link+desc-etc.?

Though there is a 'skip to content' link visible with keyboard, it does not skip the website header. https://www.w3.org/TR/WCAG20-TECHS/G1.html

it seems that the theme playground uses a wrong schema.json for the syntax checking

Before

Composition
Data
Mark
Visual Channel
Genome
User Interaction
Semantic Zoom

After

Genome
Data
Mark
Visual Channel
Composition
User Interaction
Semantic Zoom

When we are able to collect multiple community examples, we can add a page or a section that lists up a number of good examples generated by the community.

Similar to https://vega.github.io/vega-lite/examples/#community-examples

Whenever we feel ready, we need to set up a domain, i.e., gosling-lang.org, for the website.

We can add an ISMB tutorial page that includes details about the tutorial (e.g., motivation, schedules, presenters) that are in our proposal. We can use this page to advertise our tutorial on Tweet.

Reference: https://zitniklab.hms.harvard.edu/biomedgraphml/
Our proposal: https://docs.google.com/document/d/1n-3qB43HoUuVuspH7uAFUGUGRrELcK2A0zow6kkb1Kk/edit?usp=sharing

People are actively asking questions about Gosling.js, and we can update our website to help future users find the proper information before asking.

While some descriptions can be added directly to existing pages of the documentation, some of them do not seem to have good-fitting sections or pages. We could probably create a "Frequently Asked Questions" page or section and provide those descriptions.

Such examples include, but not limited to,

• How to debug gosling specs? (gosling-lang/gosling.js#551 (comment))
• Tooltips are hidden under another component (gosling-lang/gosling.js#528)
• Visualization is rendered, but hidden (gosling-lang/gosling.js#534 (comment))
• How to make Gosling visualization responsive? (gosling-lang/gosling.js#528 (comment))

Related question received:

gosling-lang/gosling.js#975 (reply in thread)

Ordering of categories in sidebar is not the same as in main page in example overview on the website.

In the main view, the order is 'Basic Marks', 'Compositive Visualizations', 'Interactive Visualizations'. In the sidebar, 'Compositive Visualizations' and 'Interactive Visualizations' are swapped.

I am unsure what would be the reason for this, but syntax highlighting is applied correctly for the first few seconds when I refresh the page, but then it is shown incorrectly (no highlighting with no newlines).

This issue happens on the following two pages:

• http://gosling-lang.org/tutorials/
• http://gosling-lang.org/tutorials/create-multi-view-visualization/ and

The version in the example is far behind a current version

We need to add a description of VCF data support (v0.9.19) which is currently missing in the Data page (http://gosling-lang.org/docs/data).

Definition in Gosling.js:

https://github.com/gosling-lang/gosling.js/blob/9f921168b62ebe32eade019e1438ca755110c238/src/core/gosling.schema.ts#L1029

• URL: https://gosling.js.org/?gist=flekschas/e6e388332814886d4d714efd0e88093b
• Page: http://gosling-lang.org/docs/

Related question received:

gosling-lang/gosling.js#969

See gosling-lang/gosling.js#1021

http://gosling-lang.org/docs/data#json-no-higlass-server

The section name can be "When To Use Gosling?"

We can provide concrete examples about

• expressiveness (e.g., circular layouts, custom tracks)
• semantic zooming
• coordinated interactions with other components (e.g., tables, buttons, selection)

cc @ngehlenborg

https://gosling.js.org/?example=RESPONSIVE_MULTIVEC

https://gosling.js.org/?example=RESPONSIVE_IDEOGRAM

https://gosling.js.org/?example=RESPONSIVE_COMPARATIVE_VIEWS

When accessing the online editor fully through screen reader and keyboard, everything in the spec after 3 indentations is shown as 'blank'.

From http://gosling-lang.org/themes/,

switching from "Light" to "UCSC" of the dropdown menu makes the website crashes.

If can be added easily, it would be great to add a search box that allows users to find keywords in docs as in the Docusaurus webpage.

For the HiGlass users, it would be good to add descriptions about how custom Gosling tracks can be used along with HiGlass tracks.

Reference: hms-dbmi/cistrome-explorer

https://docusaurus.io/docs/migration/v3

Related issues and PR:

• gosling-lang/gosling.js#532
• gosling-lang/gosling.js#523
• gosling-lang/gosling.js#529 (comment)

http://gosling-lang.org/examples/

Probably, simple z-index between the footer and the side panel would work

We can wait until we provide new functionality specified on the below link:

gosling-lang/gosling.js#564 (comment)

Refer to gosling-lang/gosling.js#579 (comment)

In the dark mode,

• Some parts of the website become difficult to read (e.g., "Get Started" on the home page and "Tips" on the public data page). We can update styles to make them more readable.
• Code blocks become visually too highlighted. Perhaps, use a dark theme in the browser's dark mode?

Screenshots: