[Bug 268764] fdp-primer: code block updates

From: <bugzilla-noreply_at_freebsd.org>
Date: Thu, 05 Jan 2023 09:07:06 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=268764

            Bug ID: 268764
           Summary: fdp-primer: code block updates
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Books & Articles
          Assignee: doc@FreeBSD.org
          Reporter: jethro@jethron.id.au

Created attachment 239275
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=239275&action=edit
8 patch files described above

Hoping to make some contributions to the documentation so started with reading
the FDP guide.

Found a few issues, have broken the patches up and they're mostly pretty tiny
so hopefully this one PR is OK.

1: Fixes a few AsciiDoc syntax issues I noticed
2: Note that you may already have vale installed if you installed docproj as it
is already a dependency of that metaport
3: Add some source lang tags to a bunch of code blocks
4: Add some descriptive links to the Emacs config section, and fix the sample
XML provided
5: Some small punctuation/grammar tweaks
6: Should fix #268238
7: Show the language when you hover over a code snippet, similar to the
official AsciiDoctor documentation
8: Small tweaks to the display of titles for code snippets (as introduced in
patch 3)

-- 
You are receiving this mail because:
You are the assignee for the bug.