gsa / digitalgov.gov Goto Github PK
View Code? Open in Web Editor NEWDigital.gov: Better websites. Better government.
Home Page: https://digital.gov
License: Other
Digital.gov: Better websites. Better government.
Home Page: https://digital.gov
License: Other
The Checklist of Requirements for Federal Websites and Digital Services page needs to be updated to be more mobile-friendly and readable. It is currently a two-column layout within a two-column layout.
The migration process was not kind to this page. None the less, it can be a lot more readable.
We should be displaying the This page was last updated on:
info in all of our pages. It can link directly to the GitHub commit for that page
See: https://gohugo.io/variables/git/
Put this in the config:
enableGitInfo : true
Sample code:
<em>Updated: {{ .Page.Lastmod }}, Version: {{ .GitInfo.Hash }}</em>
Best example at https://www.usa.gov/
18f.gov and many others are missing the newer "Here's how you know" link that expands the banner
We collect information about our DGU classes BUT are we collecting and tracking the right information? How is this information helping us tell a story and measuring impact?
FY17 metrics - https://docs.google.com/spreadsheets/d/1-YmxSGxY3Fz7-PHS4CyYjMTmBEnG_nlsCO1u4uEyYDU/edit#gid=1083370486
FY18 metrics - https://docs.google.com/spreadsheets/d/197hFlT9Rnf00iIs3huf8YlomsKwWAMoKbxT7ooxsZ_Y/edit#gid=1083370486
There are many tasks associated with setting up a YouTube live event and we need a document/checklist with all of those tasks. Some examples of specific tasks:
Do we know where we have accessibility problems? I know there are resources within 18F and elsewhere to perform an accessibility audit — and this would probably be a good way to understand our current state and how to measure our progress.
I think we all agree that accessibility concerns are both important to our readers. Additionally, they're important drivers for other design, code, and user experience improvement. Let's make it a priority and take the first step.
Explore using GitHub Issues as a way to leave a comment on a page
One Issue per page
Published September 25, 2017
Authors
✏️✏️✏️✏️✏️✏️✏️✏️✏️✏️
Use this issue to discuss the article.
Edits and corrections can be posted here or filed as their own issues. View this post in Github
We have a Style Guide we created for DigitalGov when we launched in 2014. It's been updated a few times since then, but with our move to digital.gov and on the Federalist platform, we should take another look and update.
We should also include any guidance around our new brand, in the updated Style Guide.
Here is the doc: https://docs.google.com/document/d/1QPSNAa9GGoy_BoaAlQ0yP6uDuIG_eijoYW5x6Qxy7gk/edit#
We are moving digitalgov.gov
from a database-driven, memcached version of WordPress to static-file version of our site that is built and supported by Hugo, Federalist and Cloud.gov.
Over the last few months, we’ve done our best to replicate the site as is. Why?
But before we make the move and start making the site better, we'd like to capture a baseline set of diagnostics around the current site so that we have great data to measure future changes against.
What automated tests should we run on the existing site?
DigitalGov.gov on WordPress — https://www.digitalgov.gov
demo.digitalgov.gov on Federalist — https://demo.digitalgov.gov
We migrated around 1902 posts, pages and events from WordPress to Hugo/Federalist.
Resources search box on https://www.digitalgov.gov/resources/
I searched for analytics and got 5 pages of results..
a - 32 of 41 results have this in results summary:
*Challenges & Prizes · Content Management Systems · CrowdSource Mobile Testing · Data.gov · Digital Analytics Program (metrics) · Electronic ... *
but that text is not anywhere on those pages; it's from the Services drop down menu.
b - the Resources page is included in results (shouldn't that be filtered out?)
I searched for Section 508
Got 1 page of results.. the Resources page is also included in results, but all else is normal; "section 508" appears in text of those pages.
Searched for CMS
Got 1 page of results..
Our content is structured with tags and categories to make content easier to find and sort, but there's a lot of redundancy between the taxonomy of our tags and categories — and we don't have much good information about how people use this organization to find what they're looking for.
We need to understand how we're using tags and categories, learn industry best practices for organization, and discover how our readers use this navigation aid on our site. Then we can go in and do the hard work of updating our tags and categories to better suit the content and our readers' needs.
We want to create a moderator script to be sure they cover all necessary information at both the beginning and end of each event. It will also be helpful as a guide for how long introductions of presenters should be and anything else relevant to moderating an online event.
There is growing interest within TTS to have a home for how-tos, templates, documentation, and examples of agencies taking action around Service Design and there are many teams that are already taking advantage of service design blueprints as a means of drawing a larger picture of how services are delivered and that components go into making it possible.
This is a request to start a resource page on DigitalGov where we can link to the tools, resources, and documents that already exist.
To get this page going, I would suggest that we reach out to the #service-design
channel in the TTS Slack for examples.
Example:
https://www.digitalgov.gov/categories/managing-digital/
There are a lot of posts here. @ToniBonittoGSA suggested that we break them up into 10 or 20 posts per page.
13 redirects (12, plus 1 vanity URL) listed on
https://www.digitalgov.gov/wp-admin/tools.php?page=redirection.php
Menu has links for: Redirects | Groups | Modules | Log | 404s | Options | Support
There is an "RSS Token" under Options, and I see a button to import redirections from an existing .htaccess file, or a CSV file, but not to export.
Like most blogs, the current way that the DigitalGov.gov homepage is produced is based off of feed of new blog posts, but this model is not ideal for a site like DigitalGov that has a diverse body of content, across a number of different content types. Here are some of the problems with a feed-based layout for a homepage:
The second set of issues with the current DigitalGov.gov homepage is with the specific layout of the items on the page.
The last set of problems with the current DigitalGov.gov homepage design is around the package of content that is being featured, and what it is communicating to the reader.
Obviously, a change like this will include many open issues and tasks. We will update them here as they are opened/closed.
We should have a resource page on DigitalGov for GitHub.
For starters, maybe it can include:
https://www.digitalgov.gov/contact-us/
Link on article guidelines goes to https://www.digitalgov.gov/join-digitalgov.md
should be: https://www.digitalgov.gov/join-digitalgov#guidelines (there's an anchor link on the H2)
During the migration we ended up moving over all of our resource pages, including a handful of the pages that we hoped to kill and redirect in the process. 😕
https://www.digitalgov.gov/resources/
Which means, that we have a lot of pages that are old or dead, or pages that we no longer need or want. There are probably a number of pages that need a considerable amount of formatting and cleanup.
We need to go through all of them and determine
We should also figure out how we would like to structure for the files in the repo.
We need to:
Pages with lots of entries, like community pages and resource pages, can be difficult to navigate. Long pages are OK for long-form reading, but when you need to scan information, or find a specific piece of information on a page, long pages benefit from making it easier to understand the content at a glance.
This can be done with information architecture, navigation, typography, or other layout tricks, but at the end of the day, the goal is to convey a page's contents as quickly and clearly as possible. Right now, we have too many pages that require some real effort to parse.
Take a look at how we are writing our event pages and come up with style guide for copy on event pages. This will help us (DGU team) and partners who write the event text.
Msg from Lisa re: Open Opps users in military/Defense having difficulty reading newsletters sent via HubSpot. Images and links blocked/stripped down.
Text version that HS also sends looks worse. One user asked if she could send an attached Word doc -- but HubSpot is Marketing/CRM Software, not an email client like Outlook or Gmail.
Solution(s)?
HubSpot Academy
"How do I generate a plain text email?"
https://knowledge.hubspot.com/articles/kcs_article/email/how-do-i-generate-a-plain-text-email
"Can I send only the plain text version of my email?"
https://knowledge.hubspot.com/articles/kcs_article/email/can-i-send-only-the-plain-text-version-of-my-email
We are ready to switch our root DigitalGov.gov from WordPress to Federalist, or from GSA hosted DNS to Route53 hosted DNS.
There are currently a number of sub-domains tied to the digitalgov.gov record that will also need to move over to Route53 with this change
We can do this with no downtime.
We just need to replicate the existing set of DNS records for all the subdomains in Route53.
Update:
We are going to ask GSA IT to point the www
sub-domain of digitalgov.gov
at CloudFront for now — thus, not having to move all the sub-domains that are currently associated with digitalgov.gov
at this time.
This also means that we’ll be relying on the apache config that SITES program currently has in place to redirect the root digitalgov.gov
to www.digitalgov.gov
. If/when that goes away after Jan 31, we’ll need to figure out another solution.
For the product, this is an acceptable solution since we’ll be moving DigitalGov.gov over to the digital.gov domain in the next 3-5 months.
www
sub-domain6 podcasts are on iTunes and SoundCloud
https://itunes.apple.com/us/podcast/digitalgov-podcast/id1042016789
https://www.soundcloud.com/digitalgov (have to be logged out of GSA network to view)
DigitalGov Podcast: Behind the Scenes of the Social and Behavioral Science Team
https://www.digitalgov.gov/2016/04/04/digitalgov-podcast-behind-the-scenes-of-the-social-and-behavioral-science-team/
DigitalGov Podcast: DAP Delivers Data for 4,000 Websites
https://www.digitalgov.gov/2015/06/29/digitalgov-podcast-dap-delivers-data-for-4000-websites/
DigitalGov Podcast: Leaders Come and Go, But Your Customers Will Remain
https://www.digitalgov.gov/2015/07/17/digitalgov-podcast-leaders-come-and-go-but-your-customers-will-remain/
DigitalGov Podcast: The Secrets Behind CIA Social Media
https://www.digitalgov.gov/2015/08/25/digitalgov-podcast-the-secrets-behind-cia-social-media/
DigitalGov Podcast: Bridging Content and Discovery Through DigitalGov Search
https://www.digitalgov.gov/2015/10/30/digitalgov-podcast-bridging-content-and-discovery-through-digitalgov-search/
1 is missing on site:
DigitalGov's Inaugural Podcast: How IVR Supports Contact Centers
https://www.digitalgov.gov/2015/04/30/digitalgovs-inaugural-podcast-how-ivr-supports-contact-centers/
Three videos (from: https://youtu.be/bXppIJ1K3GM)
Events
https://demo.digitalgov.gov/events/
https://demo.digitalgov.gov/event/an-around-world-recap-plain-monthly-meeting/
https://demo.digitalgov.gov/event/dap-learning-series-visualizing-analytics-data-part-2/
https://demo.digitalgov.gov/event/connect-with-your-spanishlanguage-audience-on-social-media/
Featured images missing; need for social sharing
The 3 above are all online.. can we embed Google Maps for those with physical locations?
Pages menu to archive points to https://www.youtube.com/user/howtogov
should be https://www.youtube.com/c/DigitalGov
DGU page
live: https://www.digitalgov.gov/digitalgov-university/ (not 2-column)
demo: https://demo.digitalgov.gov/digitalgov-university/ (2-column)
Form link now to Google doc, but many agencies block them.. what's Plan B?
Original in WP: https://www.digitalgov.gov/digitalgov-university/digitalgov-university-event-and-training-request-form/
Image on Demo is too small and should be centered https://s3.amazonaws.com/sitesusa/wp-content/uploads/sites/212/2017/06/600-x-445-SocialGov.jpg
The Add This/Share icons missing
Link on Recaps button is broken -
live: https://www.digitalgov.gov/tag/recap/
demo: https://demo.digitalgov.gov/tag/recap (404 page)
The Negotiated Terms of Service Agreements page is one of our most visited pages.
We should make some improvements to these pages so that they are more readable.
Homepage
https://demo.digitalgov.gov/index.html
Keyboard tabbing
ok until I hit articles; no dashed outline around featured images; is on 'read more' button and title
There used to be dashed outline around the Search button at top right, but, I see is missing on live and demo sites
Events
tab order goes thru each event ok, then to View All Events, which is above the events; it should be below.
Has 3 events for this month; live only has 2 -- should Janelle/CC add to live site so ppl can register?
Programs & Services
no dashed outline around featured images; is on 'read more' button and title
If still using this layout come February '18, the Sites block will have to be replaced with something else
Also, we removed Subscribe info & box from above footer last year because of HubSpot's send limit.. return?
Footer
Huge gap = Missing Twitter feed (widget broke in WP)
DG’s Social icons (header & footer)
RSS
current: https://www.digitalgov.gov/feed/
change to: ?
YouTube
current: http://www.youtube.com/user/howtogov
change to: http://www.youtube.com/c/DigitalGov
Pages nav:
Each main menu page name is missing colored highlight/visual cue for Compliance
Keyboard Tabbing
Both nav menus: on the drop down items, the bottom side of dashed outline is missing/not visible (all except last one)
Recent Posts lists don't match
Live (9 to match homepage):
3 Ways to Manage Research Projects Remotely
Machine Learning Paired with Skilled Data Scientists is the Future of Data-Driven Decision Making
Finding Usability Testers: Tips from an Army Recruiter
The Data Briefing: How to Build a Chatbot in a Weekend
Slack AMA Connects Standards Team with Public
Managing Custom Software Development in Government When You’re Not a Software Engineer
A Conversation With ITIF About the State of Federal Government Websites
The Data Briefing: Will Artificial Intelligence Tools Replace or Augment Federal Employees?
Design and Conflict: Do You Know Your Conflict Style?
Demo (10):
3 Ways to Manage Research Projects Remotely
Machine Learning Paired with Skilled Data Scientists is the Future of Data-Driven Decision Making
Finding Usability Testers: Tips from an Army Recruiter
The Data Briefing: How to Build a Chatbot in a Weekend
Slack AMA Connect Standards Team with Public
Managing Custom Software Development in Government When You’re Not a Software Engineer
the 'A Conversation With ITIF...' post is missing
The Data Briefing: Will Artificial Intelligence Tools Replace or Augment Federal Employees?
Design and Conflict: Do You Know Your Conflict Style?
The Data Briefing: How Blockchain’s Future Growth Will Affect Federal Agencies
USA.gov and GobiernoUSA.gov Measure Content Efficiency With New KPI Metric ( would be removed )
What is working, what is not working in our navigation?
Feel free to ✏️ this list.
create new templates for:
When we cross-post from another site, we should be using <link rel="canonical" href="#" />
to indicate that the other site is the canonical source for that content.
Here is some potential logic for that code in the head that pulls from the front-matter
{{/* Only if this is a crosspost — need to add to frontmatter */}}
{{ with $.Params.xposted_from }}
{{ "<!-- Cross posted -->" | safeHTML }}
<link rel="canonical" href="{{ . }}" />
{{ end }}
The U.S. Web Design Standards are an integral part to the tools people in Government should be using to craft government websites. In addition, they now part of the DigitalGov team.
The goal would be to drive more traffic to the Standards from DigitalGov by creating more prominent links to the Standards from within DigitalGov.
There are only a few places outside of specific blog posts that we link to the Standards. At the moment, there is a single link on the main Resources page under Design: https://www.digitalgov.gov/resources/
Here is a look at the traffic to the USWDS site from DigitalGov.gov:
(uniques / pageviews) vs number of blog posts that mention and link to the USWDS
0/0
| 0
163/237
| 0
229/311
| 0
386/529
| 0
413/620
| 0
390/625
| 0
338/457
| 0
391/506
| 0
441/626
| 0
343/440
| 3
680/861
| 3
632/820
| 2
551/725
| 2
530/692
| 2
419/555
| 0
280/390
| 0
438/602
| 1
error on HubSpot subscribe page - https://connect.digitalgov.gov/subscribe
I am subscribed to both but neither box is checked
~ the newsletter(s) you're subscribed to should be already checked [so you can unsubscribe by unchecking the box(es)]
Link to the live site is not visible like it is on other pages (see https://demo.digitalgov.gov/communities/), but on https://demo.digitalgov.gov/index.html if you hit tab key once and then hit enter, the live site opens in new tab
digitalgov.gov
Online event scheduled for 11/15 1pm - 2pm ET
event page: https://demo.digitalgov.gov/event/fedramp-tailored-overview-finalized-new-baseline/
YouTube live link: https://www.youtube.com/watch?v=MC6GfzTnaNY
FedRelay link: http://www.fedrcc.us//Enter.aspx?EventID=3444144&CustomerID=321
Google forms eval (attendee): https://docs.google.com/forms/d/e/1FAIpQLSflrZpvm3TqdxgsYYMTUNeEvWKm2UkqiujWXh1uVTELMH8H5g/viewform?usp=sf_link
In the front-matter generator, I am combing for a number of characters and converting them to entities and I get the sense that we may not need to do this for all the characters now that they are in strings (though maybe quotes?)
Would be nice to do some tests to make sure and remove some of the character conversions if we don't need them there.
Currently we use FedRelay (provided free through GSA) as our caption service for all DGU events. We've found that FedRealy/Caption Colorado isn't very accurate and we'd like to see what alternatives are available.
Randy Abramson used to work at the BBG in the government, and is now one of the heads of video at VOX in DC.
He and I had a conversation last week where he said he would be up for giving a talk to Govt about some of the YouTube video optimization + SEO work they are doing at VOX.
He sent along a deck as a preview.
Related to the Terms of Service (TOS) email chain last week -- we no longer have a gov't TOS for Google Plus.
Our old posts and comments still exist https://plus.google.com/109077476228639396954 and are still viewable to anyone not logged in via a GSA account -- however, I get this page (attached photo) when I try to view comments when logged in with my GSA account.
Should we just remove social icons in header & footer?
---
slug: an-around-world-recap-plain-monthly-meeting
title: 'An Around the World Recap PLAIN Monthly Meeting'
summary: 'In this online event, PLAIN co-chairs will provide a recap of international plain language initiatives discussed at the 2017 Plain Language Association International conference in Graz, Austria'
featured_image:
uid: tile-3
alt: 'decorative image'
event_type: online
date: 2017-10-11 14:00:00 -0400
end_date: 2017-10-11 15:00:00 -0400
event_organizer: DigitalGov University
host: PLAIN
registration_url: https://www.eventbrite.com/e/an-around-the-world-recap-plain-monthly-meeting-registration-38539458558
youtube: https://www.youtube.com/watch?v=3FKyVeipMss
---
In this month's meeting, the Plain Language Action and Information Network (PLAIN) co-chairs will provide a recap of international plain language initiatives discussed at the 2017 Plain Language Association International conference in Graz, Austria.
The second Wednesday of every month, PLAIN hosts a monthly meeting from 2-3 p.m. Hosted by Digital Gov, the meetings are recorded and posted to Digital Gov's YouTube channel.
In addition to addressing timely topics, like science communications and health literacy, typical discussions include: plain language training; hands-on editing exercises; how to write for web and social media; and content strategy.
We currently have a number of posts in Medium that we need to export and move into Federalist: https://medium.com/@DigitalGov
Once they are exported, we can easily transform them into markdown.
Note: The images might need to be uploaded separately and linked into the posts.
Communities main page
live: https://www.digitalgov.gov/communities/ (not 2-column)
demo: https://demo.digitalgov.gov/communities/ (2-column)
Add This/Share missing (this, and individual pages)
page links -
Agile/Lean:
live: https://www.digitalgov.gov/agile-lean-community-of-practice/
demo: https://demo.digitalgov.gov/communities/agile-lean/
Artificial Intelligence for Citizen Services:
live: https://www.gsa.gov/portal/content/168110
demo: https://www.gsa.gov/technology/government-it-initiatives/emerging-citizen-technology/artificial-intelligence-for-citizen-services
Blockchain:
live: https://www.gsa.gov/portal/content/168102
demo: https://www.gsa.gov/technology/government-it-initiatives/emerging-citizen-technology/blockchain
BusinessUSA:
live: none
demo: https://demo.digitalgov.gov/communities/business-usa/
Challenges & Prizes:
live: https://www.digitalgov.gov/communities/challenges-prizes-community/
demo: https://demo.digitalgov.gov/communities/challenges-prizes/
Community Solutions:
live: https://www.digitalgov.gov/communities/community-solutions/
demo: https://demo.digitalgov.gov/communities/community-solutions/
Crowdsourcing and Citizen Science:
live: https://www.digitalgov.gov/communities/federal-crowdsourcing-and-citizen-science/
demo: https://demo.digitalgov.gov/communities/crowdsourcing-and-citizen-science/
G3C:
live: https://www.digitalgov.gov/communities/government-contact-center-council-g3c/
demo: https://demo.digitalgov.gov/communities/government-contact-center-council/
Government Customer Experience:
live: https://www.digitalgov.gov/communities/customer-experience-community/
demo: https://demo.digitalgov.gov/communities/customer-experience-community/
MobileGov:
live: https://www.digitalgov.gov/communities/mobile/
demo: https://demo.digitalgov.gov/communities/mobile/
Multilingual Digital Group:
live: https://www.digitalgov.gov/communities/government-multilingual-websites-community/
demo: https://demo.digitalgov.gov/communities/multilingual/
Note: Laura Godfrey request: Mass find-and-replace after launch: Change tag https://www.digitalgov.gov/tag/multilingual-digital-group/, all text in posts & pages from "Multilingual Digital Group" to "Multilingual Community of Practice"
Open Data:
live: https://www.digitalgov.gov/communities/open-data-community-of-practice/
demo: https://demo.digitalgov.gov/communities/open-data/
OpenGov:
live: https://www.digitalgov.gov/communities/open-government-opengov-community-of-practice/
demo: https://demo.digitalgov.gov/communities/open-government/
Plain Language Action and Information Network:
live: https://www.digitalgov.gov/communities/plain-language-community-of-practice/
demo: https://demo.digitalgov.gov/communities/plain-language/
SocialGov:
original: https://www.digitalgov.gov/communities/social-media/
live: https://www.gsa.gov/portal/content/168114
demo: https://demo.digitalgov.gov/communities/social-media/
User Experience:
live: https://www.digitalgov.gov/communities/federal-user-experience-community-of-practice/
demo: https://demo.digitalgov.gov/communities/user-experience/
Video CoP:
live: https://www.digitalgov.gov/communities/video-production-pros-community-of-practice/
demo: https://demo.digitalgov.gov/communities/video-production/
Virtual/Augmented Reality:
live: https://www.gsa.gov/portal/content/168118
demo: https://www.gsa.gov/technology/government-it-initiatives/emerging-citizen-technology/virtual-and-augmented-reality
Web Content Managers:
live: https://www.digitalgov.gov/communities/web-managers-forum/
demo: https://demo.digitalgov.gov/communities/web-content-managers/
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.