w3c / w3c/csswg-drafts

[css-lists][svg-markers] `marker-side` may seem to be a `marker` longhand

Open
#6,364 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

css-lists-3 SVG
Dominant language
Bikeshed
Stars
4.9k
Forks
816
PR merge metrics
PR metrics pending

Description

https://drafts.csswg.org/css-lists/#marker-side defines marker-side, which applies to list items and affects the ::marker

But https://svgwg.org/specs/markers/ defines some properties like marker-start, marker-end or the shorthand marker. They are related to SVG <marker> elements.

I think using a similar terminology for these completely different concepts can cause confusion to authors.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by comparing the CSS Lists definition of marker-side with the SVG Markers definitions of marker-start, marker-end, and marker in the linked specifications. Done requires a resolved terminology recommendation that addresses whether authors could confuse these unrelated concepts.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.