Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Style guide updates to root pages #348

Open
RLHecht opened this issue May 14, 2019 · 0 comments
Open

Style guide updates to root pages #348

RLHecht opened this issue May 14, 2019 · 0 comments

Comments

@RLHecht
Copy link

RLHecht commented May 14, 2019

Confirm that the copyeditor checklist is complete and "heading" work in front matter is done for root pages.

Copyeditor Checklist

[ ] Search for “Servicemember” (uppercase, 1 word) on all pages.
The correct style is: “service member”
[ ] Search for “sign on,” “log in,” “login,” “log on.”
The correct style is: “sign in,” “sign out”
[ ] Scan the page for text links
Remove all periods from textual links. (Keep track in the zenhub issue of any that look awkward
because the text is super long)
[ ] Search for (ET), (CT), (PT)
Remove the parentheses around time zone. This will mostly appear where we’ve listed phone
numbers.
[ ] Scan the page for labels to change to sentence casing
• H1 titles (the title of the page) located in the front matter of the .md file
• Display titles (what shows up in the left nav) also located in the front matter
• Subheads (H2, H3, H4, which often appear as ## or ### or ####)
• Related and major links at the bottom of pages appear sometimes in a gray box (see
screenshot on the next page for a visual)
• Right column callout headings and links (see screenshot on the last page)
[ ] Note 1: Keep the following capped: Veteran / Veterans, VA.gov, proper nouns (including official
program names like Post-911 GI Bill, as well as proper nouns like Agent Orange and Gulf War)
[ ] Note 2: Keep a running list of terms here in this issue (start a new comment box below) that you're
not sure about--does VA consider them proper nouns?: "caregiver coordinator" vs "Caregiver
Coordinator"
[ ] Phone numbers
Remove the 1- before area codes, unless the information is addressed specifically to audience outside U.S. (in which case, use the +1-).
[ ] Fix hierarchy of subheads: H2-H3-H4
[ ] Add (PDF) to ends of links that link to a PDF

Add "heading" tag underneath "title" tag in front matter, copy and paste text from "title" tag and sentence case it in the "heading" tag.

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

No branches or pull requests

1 participant