Skip to content

Update npm workflow#1036

Merged
msecret merged 10 commits into
18f-pages-stagingfrom
update-docs-workflow
Mar 10, 2016
Merged

Update npm workflow#1036
msecret merged 10 commits into
18f-pages-stagingfrom
update-docs-workflow

Conversation

@maya

@maya maya commented Mar 9, 2016

Copy link
Copy Markdown
Contributor

This updates the "Using npm" docs. This also removes the version number from the CSS and JS files, while keeping it in the parent directory and zip file. We recompiled the dist/ directory.

Comment thread README.md Outdated
- stylesheets/
```

`require('uswds')` will load all of Draft U.S. Web Design Standard's JavaScript onto the page. The uswds module itself does not export anything.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey! A few comments:

I'd add "the" before "Draft U.S. Web Design Standard's JavaScript." Also, I'd recommend capitalizing "uswds" in the second sentence (because USWDS is an abbreviation of a proper noun).

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@kategarklavs thanks! done in 8640af8.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added backticks to uswds in 6436fe4 rather than capitalizing to match how we talk about it in the code.

@rogeruiz

rogeruiz commented Mar 9, 2016

Copy link
Copy Markdown
Contributor

Giving some more context around the discussion in all the line-notes.

  • Update the Downloads section of the README.md with the minified
    versions.
  • Possibly update the examples in the Downloads section with a path
    that includes lib.

@juliasolorzano

Copy link
Copy Markdown

@rogeruiz maybe one more thing to add to the checklist:

  • Update the docs to use the minified versions styleguide CSS and JS files.

@rogeruiz rogeruiz force-pushed the update-docs-workflow branch from 209c35e to d3c1b5a Compare March 10, 2016 18:01
@rogeruiz

Copy link
Copy Markdown
Contributor

@juliaelman @maya @msecret This is good to be reviewed now with the updated suggestions in the checklist! 🎉

Comment thread README.md

```html
<link rel="stylesheet" href="/path/to/your/assets/css/uswds-0.9.0.css">
<link rel="stylesheet" href="/path/to/your/assets/css/lib/uswds.min.css">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it should be /path/to/your/assets/css/lib/uswds-0.9.0/uswds.min.css.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@msecret

msecret commented Mar 10, 2016

Copy link
Copy Markdown
Contributor

LGTM, just had one comment.

msecret pushed a commit that referenced this pull request Mar 10, 2016
@msecret msecret merged commit 71cafef into 18f-pages-staging Mar 10, 2016
@maya maya deleted the update-docs-workflow branch March 11, 2016 00:16
Comment thread README.md
of your downloaded assets. And the un-minified version is better if you are in a
development environment or would like to debug the CSS or JavaScript assets in
the browser. The examples below recommend using the minified versions.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I sort imagined this paragraph would go below the link examples. Thoughts @kategarklavs? I think it's also obvious that minified is .min so not sure if we need it?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @maya — I'm totally OK with this comment appearing below the examples (we'll just need to update the last sentence to say, "The examples above recommend using the minified version."). As far as the necessity of the explanation goes: My sense is that this explanation is to help out newer users, but if it's overkill, I'm also OK with removing it.

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

Successfully merging this pull request may close these issues.

5 participants