Skip to content

NIST Pages site re-design #279

@anweiss

Description

@anweiss

User Story:

To support #273, a complete re-design of the documentation site at https://pages.nist.gov/OSCAL should be in order. As such, I propose we take advantage of the U.S. Web Design System, which is developed by GSA, in combination with the well-documented and well-maintained Jekyll static site generator framework to build a completely new landing page for OSCAL. Below are some screenshots for what a re-design might look like. If you'd like to get an idea of what the source code looks like, feel free to check out https://github.com/anweiss/OSCAL/tree/docs-redesign/docs_jekyll_uswds. It is based on GSA's Jekyll template for the USWDS. I won't push up any PRs until I get a bit more feedback on this. There's also a great opportunity for us to design our own custom, hero graphic for the homepage which accurately depicts the challenges OSCAL aims to solve and in a fun, illustrative manner.

screen shot 2018-12-14 at 3 00 50 pm
screen shot 2018-12-14 at 3 00 59 pm
screen shot 2018-12-14 at 3 01 04 pm
screen shot 2018-12-14 at 3 01 14 pm
screen shot 2018-12-14 at 3 01 25 pm
screen shot 2018-12-14 at 3 01 33 pm
screen shot 2018-12-14 at 3 01 38 pm
screen shot 2018-12-14 at 3 01 42 pm
screen shot 2018-12-14 at 3 01 46 pm
screen shot 2018-12-14 at 3 01 52 pm

CC @akarmel @bbattaglini

Goals:

Provide users with a clean, easy-to-consume experience for learning about OSCAL. Leverage the recommended design guidance for government websites provided by GSA.

Dependencies:

Definitely need to fix #148. Also dependent on #274.

Acceptance Criteria

An intuitive website is built for OSCAL.

Metadata

Metadata

Labels

EpicA collection of issues to be worked on over a series of sprintsScope: WebsiteIssues targeted at the OSCAL project website.User Story

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions