CHANGELOG.adoc 3.3 KB
Newer Older
1
2
3
4
5
6
= AsciiDoc Language Documentation Changelog

This document summarizes the changes introduced to the AsciiDoc Language Documentation by quarter.
For a detailed view of what's changed, refer to the repository's
https://github.com/asciidoctor/asciidoc-docs/commits/main[commit history].

7
8
9
10
== Published Q1 2021

Fixed::
* Rewrite much of link-macro-attribute-parsing.adoc to reflect the simplified parsing behavior implemented in https://github.com/asciidoctor/asciidoctor/issues/2059.
11
* Clarify that a negated tag selects all lines except for those lines containing a tag directive (not simply all lines as it previously suggested)
12

13
14
Added::
* Add example of how to select all lines outside of tagged regions and lines inside a specific tagged region
15
* Document attribute list parsing in detail (#43)
16
* Document the normalization applied to the AsciiDoc source and AsciiDoc include files (#51)
17

18
19
20
Changed::
* Clarify the rules for include tag filtering; emphasize that the wildcards can only be used once

21
22
23
24
25
26
27
28
29
30
31
32
== Published Q4 2020

These changes were committed and merged into the main branch starting on November 24, 2020.

Fixed::
* Replace the phrase _lead style_ with the phrase _lead role_
* Replace the table frame value `topbot` with `ends` (#9)
* Fix conflict with the built-in preamble ID
* Replace the document attribute `hardbreaks` with `hardbreaks-option` (#3)
* Fix links to page fragments (aka deep links)
* Fix grouping in navigation files
* Update xrefs to reflect module name change in asciidoctor component
33
* Document the substitution values that the inline pass macro accepts; clarify the purpose of this macro (#37)
34
* Move callouts for block image example to included line (#39)
35
* Added missing leading backslash in examples that shows how to escape an include directive
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

Added::
* Import the AsciiDoc syntax quick reference content (#14)
* Add page about abstract block style to navigation and distinguish from abstract section
* Integrate the relative link documentation into the link macro page
* Document where an anchor must be placed for a list item in a description list (#21)

Changed::
* Rework the reference table for built-in attributes by fixing incorrect values and descriptions, clarifying difference between effective value and implied value, and consolidating column for Header Only (#24)
* Fold intrinsic attributes reference into document attributes reference (#26)
* Use the term *pair* instead of *set* when referring to formatting mark complements (#6)
* Replace the phrase _set of brackets_ with the phrase _pair of brackets_ to align with updated terminology (#6)
* Replace the phrase _set of delimited lines_ with the phrase _pair of delimited lines_ (#6)
* Revise the overview page for text formatting and punctuation (#6)
* Move the hard line breaks section to a dedicated page under the Paragraphs section (#3)
* Move unordered lists before ordered lists in navigation file
* Replace fenced code blocks with AsciiDoc source blocks
* Drop unnecessary quotes in value of `subs` attribute
* Swap columns in AsciiDoc table cell example
* Use xref macro for inter-document xrefs
* Replace the name AsciiDoc Python with AsciiDoc.py
Dan Allen's avatar
Dan Allen committed
57
* Replace the term "master document" with "primary document"
58
59
60
61
62
63
* Define `navtitle` attribute on start page
* Rename version from current to latest

Removed::
* Remove migration in progress notice
* Remove disabled pages