Skip to content

Feature: table column-width control (FIXED_WIDTH per column, or evenly distributed) #631

Description

@sebsnyk

Problem

After gog docs write --replace --markdown, tables import with all columns set to widthType: EVENLY_DISTRIBUTED and no explicit width. In docs with multiple tables of varying intent, users often want per-table column-width tuning — e.g. narrow a small label-value table; keep a wide multi-column data table at full width. No CLI surface for this today.

Repro (v0.18.0)

gog docs --help | grep -iE "column|table-(format|width)"
# (only 'insert-table' for native table insertion; no column-width modifier)

gog docs format --help | grep -iE "table|column|width"
# (no table flags)

Proposed fix

Either:

  1. docs table-column-width <docId> <table-index> --col=N --width=<PT> — set FIXED_WIDTH on a specific column.
  2. docs table-column-width <docId> <table-index> --evenly-distributed — reset all columns to EVENLY_DISTRIBUTED.
  3. Bulk variant--all-tables --plan='2:250,3:200,4:180' — set per-column-count default width across all tables in the doc. Matches the common need: 'narrow most tables; leave the widest one full-width'.

Workaround today

Per-doc Docs-API updateTableColumnProperties post-process after docs write.

v0.18.0 verified

  • No table-column-width flags anywhere in gog docs.
  • insert-table accepts --rows and --cols but no width controls.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P3Low-risk cleanup, docs, polish, ergonomics, or speculative feature.clawsweeper:needs-maintainer-reviewClawSweeper marked this issue as needing maintainer review before automation.clawsweeper:needs-product-decisionClawSweeper marked this issue as needing a product or behavior decision.clawsweeper:no-new-fix-prClawSweeper does not recommend queueing a new automated fix PR for this issue.issue-rating: 🌊 off-meta tidepoolIssue quality rating does not apply to this item.

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions