observablehq / observablehq/plot
Documentation on axes repeated across multiple facets
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 5.4k
- Forks
- 244
- PR merge metrics
- No merged PRs in 30d
Description
The documentation for Facet Mark Options states:
Faceting can be explicitly enabled or disabled on a mark with the facet option, which accepts the following values:
[…]
- null (or false) - repeat this mark’s data across all facets (i.e., no faceting)
I took this to mean that Plot.axisX({facet: null}) repeats the x axis on each facet. However, it does not. The correct property to use is facetAnchor. I found that confusing.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Facet Mark Options section linked in the issue and compare its explanation of facet with the facetAnchor option used by Plot.axisX. Update the documentation so the behavior of repeating axes across facets is unambiguous, then verify that the revised wording matches the reported behavior.
Written by the indexing model from the issue text.
Assessment
- Domain
- data-visualization, documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100