Move table configuration docs from metadata.rst to configuration.rst

[simonw]

Where are all of the various table config things like sort and sort_desc and suchlike documented?

Propose a better place for that documentation

But first, pull in latest changes from main since those have even more table/column config settings

Yes, do it - I want metadata.rst to have very little table configuration in it (aside from a link to the new section)

This PR reorganizes the documentation to consolidate table-level configuration options into a dedicated section in the configuration reference, improving documentation structure and maintainability.

Summary

Table configuration documentation has been moved from docs/metadata.rst to a new "Table configuration" section in docs/configuration.rst. This change reflects the fact that these options are now primarily configured via datasette.yaml while maintaining backwards compatibility with metadata files.

Key Changes

• New section in configuration.rst: Added comprehensive "Table configuration" section documenting all table-level configuration options:

  • sort / sort_desc - default sort order
  • size - rows per page
  • sortable_columns - which columns allow sorting
  • label_column - foreign key display labels
  • hidden - hide tables from listing
  • facets / facet_size - facet configuration
  • fts_table / fts_pk / searchmode - full-text search
  • columns - column descriptions
  • column_types - semantic column type assignments

• Updated metadata.rst: Replaced detailed table configuration documentation with a brief reference pointing to the configuration.rst section, noting backwards compatibility with metadata files

• Updated cross-references: Fixed documentation links throughout:

  • docs/facets.rst - updated reference to table configuration
  • docs/full_text_search.rst - updated reference to table configuration
  • docs/json_api.rst - updated label_column reference
  • docs/pages.rst - updated hidden tables reference
  • docs/internals.rst - updated label_column reference

Implementation Details

• All configuration examples are provided in both YAML and JSON formats using the existing documentation tooling
• A note clarifies that options can be specified in either datasette.yaml or metadata files, with datasette.yaml taking priority
• Maintains all existing anchor references for backwards compatibility with external links

https://claude.ai/code/session_01UqboRB5Wt52BKPhxexUBEn

---

📚 Documentation preview 📚: https://datasette--2668.org.readthedocs.build/en/2668/

[simonw]

Here's the new section: https://datasette--2668.org.readthedocs.build/en/2668/configuration.html#table-configuration

[simonw]

.. _metadata_default_sort:

.. _table_configuration_sort:

``sort`` / ``sort_desc``

I don't like having _metadata_default_sort labels there - I do not want any of †he headings to have multiple labels. All labels in this section should be _table_configuration_x labels. If this means there is no more _metadata_x label that's fine, update any existing internal links to point to the new table configuration one instead.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.56%. Comparing base (bc7a19b) to head (2eb7c7f).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2668   +/-   ##
=======================================
  Coverage   90.56%   90.56%           
=======================================
  Files          55       55           
  Lines        8308     8308           
=======================================
  Hits         7524     7524           
  Misses        784      784           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.