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

Improve default addon README #7479

Merged
merged 1 commit into from
Dec 7, 2017
Merged

Conversation

Turbo87
Copy link
Member

@Turbo87 Turbo87 commented Dec 1, 2017

This PR changes the README.md that is generated by default for new addons in a few ways:

  • Adds an automatically generated "Installation" section
  • Adds an empty "Usage" section
  • Moves the current contents into a "Contributing" section
  • Adds a "License" section
  • Uses Setext headings to better emphasize the README sections in raw text mode

This is roughly similar to what we've been doing in some of our own addons already, e.g. https://github.com/ember-cli/ember-cli-eslint/blob/master/README.md

Resolves #7278

/cc @offirgolan

Copy link
Member

@kellyselden kellyselden left a comment

Choose a reason for hiding this comment

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

Looks great!

@@ -1,26 +1,47 @@
# <%= addonName %>

Copy link
Member

Choose a reason for hiding this comment

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

Can this blank line go away?

Copy link
Member Author

Choose a reason for hiding this comment

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

It can, I usually use it as padding, but I'm okay if we decided to remove it

Copy link
Member

Choose a reason for hiding this comment

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

I vote for removal, it looks strange to me.

Copy link
Member Author

Choose a reason for hiding this comment

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

removed

Copy link
Member

@rwjblue rwjblue left a comment

Choose a reason for hiding this comment

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

Generally 👍 , had one minor question...

Contributing
------------------------------------------------------------------------------

### Installation
Copy link
Member

Choose a reason for hiding this comment

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

Thoughts on having the Contributing section largely be a cross-link to CONTRIBUTING.md, and moving the guts of this section into that file?

Copy link
Member Author

Choose a reason for hiding this comment

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

thought about it, but given the short length and the content not really fitting with what GitHub seems to expect from that file I decided to keep it in here for now.

Copy link
Member

Choose a reason for hiding this comment

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

kk, seems fine either way to me

Copy link

@offirgolan offirgolan left a comment

Choose a reason for hiding this comment

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

Looks awesome! Thanks for taking this up.


For more information on using ember-cli, visit [https://ember-cli.com/](https://ember-cli.com/).
This project is licensed under the [MIT License](LICENSE.md).
Copy link
Member

Choose a reason for hiding this comment

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

This will make a third location that the license of the addon is indicated (package.json & LICENSE.md being the others).

Not sure that I object, but feel it is worth noting.

Copy link
Member

Choose a reason for hiding this comment

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

Yeah I wouldn't mind removing this section either.

Copy link
Member Author

Choose a reason for hiding this comment

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

I would prefer to keep it in for better visibility 🤔

@Turbo87 Turbo87 merged commit f723480 into ember-cli:master Dec 7, 2017
@Turbo87 Turbo87 deleted the addon-readme branch December 7, 2017 23:42
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.

5 participants