w system argument hard to discover when looking for 'width'

[cheshire137]

I saw #638 was closed, but I just ran into the inability to apply the width-full class to a view component in version 0.15.1 of the primer_view_components gem. I'm trying to make this view component have the width-full class:

    Primer::BaseComponent.new(
      tag: :span,
      display: :flex,
      align_items: :center,
      justify_content: :space_between,
    )

If I pass width: :full, it adds a width="full" HTML attribute to the element, but if I pass classes: "width-full", it raises an exception:

Use System Arguments (https://primer.style/view-components/system-arguments) instead of Primer CSS class name width-full.

width: "100%" also results in a width="100%" HTML attribute on the element.

[kenyonj]

You can use the sys arg w for this:

pry(main)> puts helper.render Primer::BaseComponent.new(tag: :span, w: :full)
<span data-view-component="true" class="width-full"></span>

This is listed in the "Layout" section of https://primer.style/view-components/system-arguments

[cheshire137]

Thank you! I saw width under HTML Attributes and thought it was the one I wanted:

-- https://primer.style/view-components/lookbook/pages/system_arguments

I see w under Layout, as you say, but it doesn't mention the word "width" at all. Same for h, which I'm guessing is similar but for height.

Maybe the docs could be updated so both arguments reference each other, and so w and h mention the words width and height?