You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: LICENSE.md
+21-7Lines changed: 21 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,17 @@
1
1
## A few parts of this project are not in the public domain
2
2
3
+
### Copyright ownership of Works created by U.S. federal employees
4
+
5
+
This repository contains both the original design for Google Material Icons (the “Work”, as defined in Section 1 of the Apache 2.0 License) and modifications made by the General Services Administration (GSA). This repository combines the Work and these GSA modifications, which is a “Modified Version” of Material Icons.
6
+
7
+
This repository also contains both original designs for Source Sans Pro, Merriweather, and Font Awesome (the “Font Software”, as defined in Section 1 of the SIL Open Font License, version 1.1) and modifications made by the General Services Administration (GSA). This repository combines the Work and these GSA modifications, which is a “Modified Version” of Source Sans Pro, Merriweather, Public Sans, and Font Awesome respectively.
8
+
9
+
As a work of the United States Government, the software modifications made by GSA are not subject to copyright within the United States. Additionally, GSA waives copyright and related rights in its software modifications worldwide through the CC0 1.0 Universal Public Domain Dedication (https://creativecommons.org/publicdomain/zero/1.0/).
10
+
11
+
The Work (as defined in the Apache 2.0 License) and Font Software (as defined in the SIL Open Font License, Version 1.1) remains subject to copyright under the respective open source license. The section below lists which works are subject to particular open source licenses.
12
+
13
+
This Modified Version packaged as `dist/img/sprite.svg` contains both design elements under the Apache 2.0 License and design modifications by GSA released as CC0. It is a “joint work” made of the icon set and modifications combined into a single work.
14
+
3
15
### Files licensed under the SIL Open Font License, Version 1.1
4
16
5
17
The Source Sans Pro font files in `src/fonts/source-sans-pro` are a [customized subset](https://github.com/miguelsousa/source-sans-pro-subset) of [Source Sans Pro](https://github.com/adobe-fonts/source-sans-pro) owned by Adobe Systems Incorporated, licensed under the [SIL Open Font License, Version 1.1](https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL_web), and copyright 2010, 2012, 2014 [Adobe Systems Incorporated], with Reserved Font Name 'Source'. All Rights Reserved. Source is a trademark of Adobe Systems Incorporated in the United States or other countries.
@@ -8,19 +20,17 @@ The Merriweather font files in `src/fonts/merriweather` are the version 2.001 fi
8
20
9
21
The Public Sans font files in `src/fonts/public-sans` are licensed under the [SIL Open Font License, Version 1.1](https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL_web). Public Sans is a modification of Libre Franklin, copyright [Impallari Type](www.impallari.com).
10
22
11
-
The files in `src/img` are from [Font Awesome](http://fontawesome.io/) by Dave Gandy under the [SIL Open Font License, Version 1.1](https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL_web).
23
+
Icon files in `src/img` and `src/img/social-icons` are from [Font Awesome](http://fontawesome.io/) by Dave Gandy under the [SIL Open Font License, Version 1.1](https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL_web).
12
24
13
25
### Files licensed under the Apache 2.0 License
14
26
15
27
The Roboto Mono font files in `src/fonts/roboto-mono` are licensed under the [Apache License Version 2.0](https://www.apache.org/licenses/LICENSE-2.0.txt).
16
28
17
-
The Google Material icons in `src/img/usa-icons` and `src/img/usa-icons-unused` are licensed under the [Apache License Version 2.0](https://www.apache.org/licenses/LICENSE-2.0.txt).
29
+
The Google Material Icons in `src/img/usa-icons` and `src/img/material-icons` are licensed under the [Apache License Version 2.0](https://www.apache.org/licenses/LICENSE-2.0.txt).
18
30
19
31
### Files licensed under the MIT license
20
32
21
-
The files in `src/stylesheets/lib` are from:
22
-
23
-
-[Normalize.css](https://github.com/necolas/normalize.css), copyright Nicolas Gallagher and Jonathan Neal, under the [MIT license](https://github.com/necolas/normalize.css/blob/master/LICENSE.md).
33
+
The files in `src/stylesheets/lib` are from [Normalize.css](https://github.com/necolas/normalize.css), copyright Nicolas Gallagher and Jonathan Neal, under the [MIT license](https://github.com/necolas/normalize.css/blob/master/LICENSE.md).
24
34
25
35
#### Full license text for the MIT licensed files:
26
36
@@ -44,13 +54,13 @@ Additionally, we waive copyright and related rights in the work worldwide throug
44
54
45
55
This is a human-readable summary of the [Legal Code (read the full text)](https://creativecommons.org/publicdomain/zero/1.0/legalcode).
46
56
47
-
#### No Copyright
57
+
#### No copyright
48
58
49
59
The person who associated a work with this deed has dedicated the work to the public domain by waiving all of his or her rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by law.
50
60
51
61
You can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission.
52
62
53
-
#### Other Information
63
+
#### Other information
54
64
55
65
In no way are the patent or trademark rights of any person affected by CC0, nor are the rights that other persons may have in the work or in how the work is used, such as publicity or privacy rights.
56
66
@@ -59,3 +69,7 @@ Unless expressly stated otherwise, the person who associated a work with this de
59
69
### Contributions to this project
60
70
61
71
As stated in [CONTRIBUTING](CONTRIBUTING.md), all contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.
72
+
73
+
### Trademark
74
+
75
+
GSA owns, reserves, and retains all rights, title, and interest in all trademarks owned by GSA. The User does not acquire any right or interest of any kind in any GSA trademark because of their use of the Modified Version or any of the modifications made to the Work by GSA.
-[Contributing to the code base](#contributing-to-the-code-base)
37
+
-[Reuse of open-source style guides](#reuse-of-open-source-style-guides)
38
+
-[Licenses and attribution](#licenses-and-attribution)
39
+
-[Contributing](#contributing)
37
40
38
41
## Background
39
42
@@ -62,12 +65,12 @@ How you implement the design system depends on the needs of your project and you
62
65
63
66
### Download and install
64
67
65
-
1. Download the [USWDS zip file](https://github.com/uswds/uswds/releases/download/v2.11.2/uswds-2.11.2.zip) from the latest USWDS release and open that file.
68
+
1. Download the [USWDS zip file](https://github.com/uswds/uswds/releases/download/v2.12.0/uswds-2.12.0.zip) from the latest USWDS release and open that file.
66
69
67
70
After extracting the zip file you should see the following file and folder structure:
68
71
69
72
```
70
-
uswds-2.11.2/
73
+
uswds-2.12.0/
71
74
├── css/
72
75
│ ├── uswds.min.css.map
73
76
│ ├── uswds.min.css
@@ -98,7 +101,7 @@ How you implement the design system depends on the needs of your project and you
98
101
```
99
102
example-project/
100
103
├── assets/
101
-
│ ├── uswds-2.11.2/
104
+
│ ├── uswds-2.12.0/
102
105
│ ├── stylesheets/
103
106
│ ├── images/
104
107
│ └── javascript/
@@ -118,11 +121,11 @@ How you implement the design system depends on the needs of your project and you
@@ -247,7 +250,7 @@ We recommend using a **minifier** like [csso](https://github.com/css/csso) to co
247
250
248
251
### Use another framework or package manager
249
252
250
-
If you’re using another framework or package manager that doesn’t support `npm`, you can find the source files in this repository and use them in your project. Otherwise, we recommend that you follow the [download instructions](#download). Please note that the core team [isn’t responsible for all frameworks’ implementations](https://github.com/uswds/uswds/issues/877).
253
+
If you’re using another framework or package manager that doesn’t support `npm`, you can find the source files in this repository and use them in your project. Otherwise, we recommend that you follow the [download instructions](#download-and-install). Please note that the core team [isn’t responsible for all frameworks’ implementations](https://github.com/uswds/uswds/issues/877).
251
254
252
255
If you’re interested in maintaining a package that helps us distribute USWDS, the project’s build system can help you create distribution bundles to use in your project. Please read our [contributing guidelines](CONTRIBUTING.md#building-the-project-locally-with--gulp-) to locally build distributions for your framework or package manager.
253
256
@@ -304,7 +307,9 @@ function App() {
304
307
305
308
useEffect(() => {
306
309
// initialize
307
-
characterCount.on(ref); // default ref is document.body, if you want to use default you do not have to pass arguments
310
+
characterCount.on(ref);
311
+
// default ref is document.body, if you want to use
312
+
// default you do not have to pass arguments
308
313
accordion.on();
309
314
310
315
// remove event listeners when component un-mounts.
@@ -321,7 +326,9 @@ Angular example:
321
326
```js
322
327
exportclassAppimplements OnInit {
323
328
constructor() {
324
-
this.ref=document.body; // default ref is document.body, if you want to use default you do not have to pass arguments
329
+
this.ref=document.body;
330
+
// default ref is document.body, if you want to use
331
+
// default you do not have to pass arguments
325
332
}
326
333
327
334
ngOnInit() {
@@ -338,6 +345,8 @@ export class App implements OnInit {
338
345
}
339
346
```
340
347
348
+
> Those using **Webpack 5** can take advantage of the updated exports field which allows declaration for requests like `import "uswds"` or `import accordion from "uswds/src/js/components/accordion"`
349
+
341
350
## Customization, theming, and tokens
342
351
343
352
USWDS 2.0 provides extensive support for theming via its theme settings files introduced in [Sass and theme settings](#sass-and-theme-settings), above.
Copy file name to clipboardExpand all lines: SECURITY.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ We include a security and vulnerability report with every USWDS release, and rel
15
15
We encourage you to verify the security and status of the USWDS package:
16
16
17
17
1.**Check the vulnerability badge.** Confirm the vulnerability badge in the [USWDS Github code repository](https://github.com/uswds/uswds) says there are `0` vulnerabilities.
18
-
1.**Download the package via npm.** We recommend using the [npm package](https://designsystem.digital.gov/documentation/developers/#install-using-npm) instead of the [zip file](https://designsystem.digital.gov/documentation/developers/#download), whenever possible. Using npm makes it easier to stay up-to-date and use the latest USWDS version as a project dependency, and is a secure and reliable way to download USWDS source code.
18
+
1.**Download the package via npm.** We recommend using the [npm package](https://designsystem.digital.gov/documentation/developers/#install-using-npm) instead of the [zip file](https://designsystem.digital.gov/documentation/developers/#download-and-install), whenever possible. Using npm makes it easier to stay up-to-date and use the latest USWDS version as a project dependency, and is a secure and reliable way to download USWDS source code.
0 commit comments