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

Jquery docs minor improvements #98

Closed

Conversation

pablofiumara
Copy link
Contributor

issue #75

@pablofiumara
Copy link
Contributor Author

@scottgonzalez Is there anything else I can help with? Thank you very much in advance.

- Ralph Whitbeck <[email protected]>
- John Paul <[email protected]>
---
```
Copy link
Member

Choose a reason for hiding this comment

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

I don't think there are sites still using YAML?

Copy link
Member

Choose a reason for hiding this comment

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

also this shouldn't be learn site specific.

Copy link
Member

Choose a reason for hiding this comment

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

Correct, there are no sites using YAML.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@scottgonzalez
@arthurvr

Thank you both for your comments. I fail to understand which changes should be made taking into account that there are no sites using YAML and that this should not be learn site specific. Could you explain it to me, please? Thanks in advance.

Copy link
Member

Choose a reason for hiding this comment

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

To be honest, If you don't know how the architecture of our sites is setup, you're probably not the right guy to handle this.


The thing is that, in the past, we used YAML for front matters in some sites and now we use JSON, but the example in here still uses YAML.

Also, we mean some of the properties you use in your example are specific for the learn site (learn.jquery.com). Those properties are not needed in other sites.

Remember that the original article was specific for learn.jquery.com while this one must be true for every site.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@arthurvr Thanks for the clarification.
You are right: These is my first contribution to this repository so I am not the right guy to handle this. Let's wait to hear other people's opinion.

@arthurvr
Copy link
Member

Doesn't the front-matter need to be in Contributing to web sites? (It's already partly covered in there)


Content should be educational and accessible to a broad audience of developers. The primary target audience is beginning to intermediate jQuery users, with advanced jQuery users as a secondary audience. When creating content, please keep one of these audiences in mind as well as the following style guidelines:

### Prose & Grammar
Copy link
Member

Choose a reason for hiding this comment

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

Prose is a subheading in an article regarding prose?

@@ -0,0 +1,111 @@
<script>{
"title": "Prose Style Guide"
Copy link
Member

Choose a reason for hiding this comment

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

2 spaces now? We use tabs.

@agcolom
Copy link
Member

agcolom commented Jun 9, 2015

I can confirm the CLA was signed.
@pablofiu Are you still able to amend the spaces to tabs? Otherwise, I suggest we land this PR and change spaces to tabs ourselves. @arthurvr thoughts?

@pablofiumara
Copy link
Contributor Author

@agcolom : I am able to amend the spaces to tabs but do not know which spaces you are referring to. Could you tell me about them, please? Thanks in advance.

@pablofiumara
Copy link
Contributor Author

What does CLA mean?

@dmethvin
Copy link
Member

dmethvin commented May 6, 2016

Is it okay to land this? I was going to make some edits to the pages here but it would be easier to land this first so it doesn't conflict. I can fix the spaces when I land it.

@dmethvin dmethvin closed this in 5693df6 May 12, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

Successfully merging this pull request may close these issues.

5 participants