Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add step in Installation section in README template #6914

Merged
merged 3 commits into from
Oct 9, 2018

Conversation

wooster0
Copy link
Contributor

@wooster0 wooster0 commented Oct 7, 2018

This documents the shards install step in the Installation section of the README template.
Because actually the Installation section is without this step incomplete. That's not everything you need to do to install the shard so you can use it.
So now the Installation section for a shard would look like this:


Installation

Add this to your application's shard.yml:

dependencies:
  shard:
    github: user/shard

Then run shards install.

@@ -12,6 +12,8 @@ dependencies:
<%= config.name %>:
github: <%= config.github_name %>/<%= config.name %>
```

and run `shards install`.
Copy link
Member

Choose a reason for hiding this comment

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

This should be a whole sentence (for example Then run shards install`).

Copy link
Contributor Author

@wooster0 wooster0 Oct 7, 2018

Choose a reason for hiding this comment

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

I think this is fine because Add this to your application's shard.yml:, the yaml code and this together is one sentence. "Do this and run this" instead of "Do this. Then run this". So the whole installation is "swifty" and simply described in one sentence.
In the end there isn't really a big difference I think.

Copy link
Member

Choose a reason for hiding this comment

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

It's hard to read that as a whole sentence given it's two paragraphs with a code block element in between.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants