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

Wording #123

Merged
merged 14 commits into from Jul 20, 2017
Merged

Wording #123

merged 14 commits into from Jul 20, 2017

Conversation

ghost
Copy link

@ghost ghost commented Jul 9, 2017

I know that it's a small detail, but it could really confuse someone.

And fix spacing on line 112

@alallier
Copy link
Owner

alallier commented Jul 9, 2017

While you are at it, see anything else? We might as well catch it with this one and tack it on

@ghost
Copy link
Author

ghost commented Jul 10, 2017

@alallier I'll have a look

@ghost
Copy link
Author

ghost commented Jul 10, 2017

Would it be a good idea to have a link to the license, rather than just saying (MIT License)? I would make the (MIT License) a link to your license file.

@alallier
Copy link
Owner

Sure go ahead and do that please

-p, --port [port] The port to bind to. Can be set with PORT env variable as well. Defaults to 8080
-s, --start-page [start-page] Specify a start page. Defaults to index.html.
-v, --verbose Turns on logging on the server and client side. Defaults to false.
-h, --help output usage information
Copy link
Owner

Choose a reason for hiding this comment

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

What is the diff here?

Copy link
Owner

Choose a reason for hiding this comment

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

Lets try and keep this to just any problems in docs you see like the wording problem. We can spice up and add things at a later time, as I have more doc changes coming later anyways

Copy link
Author

@ghost ghost Jul 10, 2017

Choose a reason for hiding this comment

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

The main difference was adding [verbose] to the line 209, so that it looked exactly like the output from reload -h

Copy link
Owner

Choose a reason for hiding this comment

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

Okay that sounds good, why the diff on 201 to 208?

Copy link
Author

Choose a reason for hiding this comment

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

There isn't any difference. It might be because I am on linux and it is changing the line endings?

Copy link
Author

@ghost ghost Jul 10, 2017

Choose a reason for hiding this comment

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

I ran reload -h and copied the output straight from the terminal.

Copy link
Owner

Choose a reason for hiding this comment

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

I see it's the spacing between the first and second columns that is different. This is good though, I like this because it is an exact copy of what reload -h provides.

@ghost
Copy link
Author

ghost commented Jul 10, 2017

In the Table of Reload Parameters, is it really necessary to call the opt optional in the description when there is an optional checkbox next to it?

Basically, can i remove optional from the description of opt because it seems superfluous.

@ghost
Copy link
Author

ghost commented Jul 10, 2017

And do we need curly braces around the type for the Parameter tables?

README.md Outdated
```

License
---

(MIT License)
[(MIT License)](https://github.com/alallier/reload/blob/master/LICENSE)
Copy link
Owner

@alallier alallier Jul 10, 2017

Choose a reason for hiding this comment

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

Anyway to make this relative. Kind of like how I did here in the CHANGELOG Please refer to the full API in the [README](README.md#api-for-express). Should be able to reference the file without the URL. Test it out and let me know

Copy link
Author

Choose a reason for hiding this comment

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

Fixed. See commit 6bacf6f

Copy link
Author

@ghost ghost Jul 10, 2017

Choose a reason for hiding this comment

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

Should I make the link to the expressSampleApp a relative link as well? Or if not, at least change the link from jprichardson to alallier.

Copy link
Owner

Choose a reason for hiding this comment

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

Nice catch, yeah let's doing something with that. I don't know if you can make it relative? Try it out if not, the update from jprichardson to alallier would be great

@alallier
Copy link
Owner

I like how the optional is the description it makes it really clear that it is optional and doesn't hurt to have it in there. The clearer we can be the less questions and problems our users will run into.

We don't necessarily need the brackets around the types, but it kinda feels right especially since in JSDocs the type is wrapped in brackets Actually yeah you can remove the brackets and it will give consistency because I didn't do brackets in the return table.

@ghost
Copy link
Author

ghost commented Jul 11, 2017

Sorry about the name of that commit. For some reason I thought I could use markdown in the commit. What I meant was

Shorten ```javascript to ```js

README.md Outdated
@@ -70,7 +70,7 @@ Reload can be used in conjunction with tools that allow for automatically restar
### Express Example

**`server.js`:**
```javascript
```js
Copy link
Owner

Choose a reason for hiding this comment

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

This is unnecessary diff. Let's leave this how it was.

Copy link
Author

Choose a reason for hiding this comment

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

Changed it back ab7340b

Copy link
Author

Choose a reason for hiding this comment

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

Change javscript to javascript 6fca6fe

@alallier
Copy link
Owner

Lets get that link updated and get this merged in.

@ghost
Copy link
Author

ghost commented Jul 11, 2017

Changed the link to relative 3140125

@alallier
Copy link
Owner

Relative link is really cool. Looks good for merge. Planning to get this in with #128 and #125.

@alallier
Copy link
Owner

Thanks again!

@alallier alallier merged commit d1aa4e4 into alallier:master Jul 20, 2017
@ghost ghost deleted the wording branch July 20, 2017 21:33
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.

1 participant