Skip to content

History / xref

Edit page New page

Revisions

  • docs: address reviewer feedback from Tab Atkins, annevk, Domenic personas xref.md — add pipeline explanation showing how Reffy/WebRef/xref-service works and what's required for a term to be findable (browser-specs, data-export, Reffy crawl). Addresses Anne's 'the dependency is undocumented'. a11y.md — add table of the four rules disabled by default (color-contrast, landmark-one-main, landmark-unique, region) with reasons. Addresses 'you never list the defaults'. document.respec.md — add full error/warning object fields: title, elements, details, cause (all from RespecError.toJSON()). Addresses Domenic's 'partial docs are worse than no docs'. preProcess.md / postProcess.md — replace toy examples with realistic use cases (fetching external data and injecting dfns; validating output). Addresses Domenic's 'the examples are toys'. data-cite.md — add 'when to use data-cite' decision table; add <dfn data-cite> re-export pattern. Addresses Domenic's 'you never explain the affirmative use case'. Writing-Algorithms.md (new) — algorithm prose conventions: ol.algorithm, variable syntax, standard verbs (Let/Set/Return/Assert/For each), Assert step handling, nested sub-steps, abstract operations, data-algorithm. Addresses the missing 'how to write algorithm prose' gap flagged by both annevk and Domenic. Added to sidebar. _Sidebar.md — add Writing Algorithms to guides section.

    @marcoscaceres marcoscaceres committed Mar 28, 2026
    2d49b69

  • docs: rewrite 43 high-priority wiki pages Rewrites the most-visited configuration and authoring docs with: - Type annotations and defaults on every page - Markdown tables replacing HTML dl elements - Live examples using the js/html "example" annotation format - Accurate information sourced directly from the ReSpec source modules - Complete person object documentation - Full specStatus value tables with required fields - Structured linting rule pages with violation examples and fixes Pages rewritten: editors, specStatus, person, github, xref, caniuse, mdn, localBiblio, lint, data-cite, note, issue, example, data-dfn-type, data-lt, data-include, data-export, figure, shortName, group, data-dfn-for, preProcess, postProcess, authors, formerEditors, markdown, data-link-for, no-unused-dfns, local-refs-exist, no-http-props, wpt-tests-exist, data-sort, conformance, data-tests, appendix, informative, no-headingless-sections, license, addSectionLinks, edDraftURI, no-captionless-tables, logos, ednote

    @marcoscaceres marcoscaceres committed Mar 27, 2026
    9d5e1bb

  • prefer export css class

    @marcoscaceres marcoscaceres committed Mar 17, 2022
    da2517c

  • Changed http links to https

    @somyadwivedi-mriirs somyadwivedi-mriirs committed Oct 26, 2020
    3f582af

  • Additional example for using xref

    @marcoscaceres marcoscaceres committed Jul 26, 2020
    62cec1b

  • spelling fixes

    Sid Vishnoi committed Jul 8, 2020
    e181280

  • remove reduntant 'Example:' headings as examples are marked already

    Sid Vishnoi committed Jul 8, 2020
    4ba0670

  • mark some code blocks as examples and add titles

    Sid Vishnoi committed Jul 7, 2020
    0b47f38

  • xref: wrap heading in code, as config option

    Sid Vishnoi committed Jun 30, 2020
    873e18d

  • use relative links to wiki pages

    Sid Vishnoi committed Jun 30, 2020
    98be4a6

  • Run all files through prettier Why? To make all files consistent. Changes can be summarized as: - Remove trailing whitespace - Added EOF newlines - Added newlines between headings and other content - Added semicolons, commas in JS snippets - Formatted all other snippets - Formatted tables (headers are as wide as widest column) - Use - for list markers instead of * - Fix some invalid HTML (i.e., adding missing closing tags) - Changed some snippets for consistency

    Sid Vishnoi committed Jun 30, 2020
    f76292a

  • Updated xref (markdown)

    Sid Vishnoi committed Jun 23, 2020
    f127915

  • Updated xref (markdown)

    Sid Vishnoi committed Jun 23, 2020
    b786703

  • style: use <h1> in each wiki item, fix headings

    Sid Vishnoi committed Jun 17, 2020
    d58254b

  • remove internal URL config

    Sid Vishnoi committed Apr 20, 2020
    34ea779

  • Updated xref (markdown)

    Sid Vishnoi committed Apr 20, 2020
    accec7b

  • No longer in beta

    @marcoscaceres marcoscaceres committed Mar 11, 2020
    060d55f

  • experimental => beta

    Sid Vishnoi committed Aug 22, 2019
    46cdb68

  • Updated xref (markdown)

    Sid Vishnoi committed Apr 29, 2019
    cb6d225

  • Updated xref (markdown)

    @marcoscaceres marcoscaceres committed Apr 29, 2019
    9254a96

  • Updated xref (markdown)

    @marcoscaceres marcoscaceres committed Apr 29, 2019
    cabf673

  • Updated xref (markdown)

    @marcoscaceres marcoscaceres committed Apr 29, 2019
    eb3b9ef

  • Add experimental flag

    Sid Vishnoi committed Mar 31, 2019
    87bb479

  • Minor Corrections, emphasized use of specs with profile

    @Swapnilr1 Swapnilr1 committed Mar 31, 2019
    b073906

  • Created xref (markdown)

    @Swapnilr1 Swapnilr1 committed Mar 30, 2019
    874f830