Skip to content

Added explicit anchors to section headings in the user guide.#7762

Merged
feerrenrut merged 5 commits into
nvaccess:masterfrom
ThomasStivers:f1Help
Dec 21, 2017
Merged

Added explicit anchors to section headings in the user guide.#7762
feerrenrut merged 5 commits into
nvaccess:masterfrom
ThomasStivers:f1Help

Conversation

@ThomasStivers

Copy link
Copy Markdown
Contributor

Link to issue number:

Part of #7757.

Summary of the issue:

The user guide contains automatically generated anchors for many sections. These cannot be consistently linked to because the guide may be reorganized.

Description of how this pull request fixes the issue:

Instead of letting anchor names for section headings be generated here they are specified so they can be used by a context sensitive help system.

Testing performed:

Used scons user_guide and verified that the links in the table of contents and the anchors at section headings work as expected.

Known issues with pull request:

This makes the source of the user guide slightly less pretty.

Change log entry:

No user visible changes.

@LeonarddeR

Copy link
Copy Markdown
Collaborator

Though it would make your pr way more huge, personally I'd also add anchors to the several options (e.g. ==== Language ====, ==== Show exit options when exiting NVDA ==== . That would really improve things if something like context sensitive help would be implemented.

@feerrenrut

Copy link
Copy Markdown
Contributor

@ThomasStivers could you please split out the work on context separate help into a new PR.

feerrenrut added a commit that referenced this pull request Dec 11, 2017
Merge remote-tracking branch 'origin/pr/7762' into next

 Conflicts:
	user_docs/en/userGuide.t2t
@michaelDCurran

Copy link
Copy Markdown
Member

@feerrenrut: As this only changes the user guide, can this be merged to master as soon as possible? Recent merges to master have now made this out of date with conflicts that need to be resolved. Merging current master to next is also currently very tricky.

feerrenrut added a commit that referenced this pull request Dec 21, 2017
Merge branch 'pr7762' into next
@feerrenrut feerrenrut merged commit 0f86440 into nvaccess:master Dec 21, 2017
@nvaccessAuto nvaccessAuto added this to the 2018.1 milestone Dec 21, 2017
@josephsl josephsl mentioned this pull request Jun 1, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants