Skip to content

Instantly share code, notes, and snippets.

@5t3ph
Last active July 7, 2020 16:43
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save 5t3ph/51185884aeab155e3f40aa4ec6f8b71a to your computer and use it in GitHub Desktop.
Save 5t3ph/51185884aeab155e3f40aa4ec6f8b71a to your computer and use it in GitHub Desktop.
[DRAFT] Style Stage Guidelines

The HTML for this page was created to be semantic, accessible, and free of nearly all other opinions. While typically extra divs are to be avoided, each sectioning element also includes a .container div as the first child for use as a styling aid since you do not have access to alter the base HTML. IDs are included where needed for nav anchors or accessibility, and a small number of additional classes are provided for key elements without IDs.

As a contributor, you agree to abide by the following guidelines and restrictions:

  • Branding is prohibited with the exception of Monthly and Weekly sponsors.
  • The HTML is not available to modify, except for attribution values that will be added from your submission metadata.
  • You may use any build setup you prefer to create your stylesheet, but the final submission should be the compiled, unminified CSS.
  • Stylesheets will become hosted locally to the project as well as be run through autoprefixer and minified to ensure optimal performance.
  • Submissions will have licensing and attribution added upon the processing of the provided metadata.
  • Any changes made past initial submission will be revealed in the version history and reviewed to ensure guidelines are still met. Removal of the public stylesheet will result in removal from Style Stage.
  • You retain copyright over original graphics, and your stylesheet will receive the CC BY-NC-SA license.
  • All asset links, including fonts, must be absolute to external resources. Broken asset links will lead to removal.
  • Page load time should not exceed 3 seconds. Note: This site is built with Eleventy and hosted on Netlify, so your local load time will likely be very close to production load time.
  • There should be no contrast errors dedicated when validated against tools like WAVE or aXe. Include any notes about false errors in your pull request.
  • All graphic assets should respect copyright laws and be licensed appropriately.
  • Designs should be responsive and usable across the most widely supported browsers (check caniuse data as needed)
  • When cutting-edge properties are used, appropriate fallbacks should be provided if there is a significant impact on the user experience, particularly as it relates to accessibility.
  • Animations should be removed via prefers-reduced-motion. The reset included with the source CSS demonstrates how to do this.
  • No content may be permanently hidden, and hidden items must come with an accessible viewing technique.
  • Submissions will be rejected for using obscene, excessively violent, or otherwise distasteful imagery, violating the above guidelines, or other reasons at the discretion of the maintainer. You may be asked to make revisions for minor violations.
  • Submissions may be removed if future changes are made that violate the guidelines, or if notice is received of copyright violations.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment