Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

[Cookbook] apply headline guidelines to the cookbook articles#4042

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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
weaverryan merged 1 commit intosymfony:2.3fromxabbuh:headline-standards-cookbook
Jul 29, 2014

Conversation

@xabbuh
Copy link
Member

QA
Doc fix?yes
New docs?no
Applies toall
Fixed tickets

This completes the work started in#3765,#3828 and#3829.

@xabbuhxabbuh changed the titleapply headline guidelines to the cookbook articles[Cookbook] apply headline guidelines to the cookbook articlesJul 20, 2014
@javiereguiluz
Copy link
Member

👍 Awesome work@xabbuh!

Somewhat related to this, do you think it could be necessary to updated thedocumentation standards related to capitalization and closed-class words? Currently is just a link to a very dense Wikipedia article.

@wouterj
Copy link
Member

@javiereguiluz what would you update? The text itself does say it all actually, no need to click on the link

@javiereguiluz
Copy link
Member

@wouterj you are right that the standard clearly states the rule:

Capitalization of the first word, and all other words, except for closed-class words.

The problem is that, as any other "rule" related to human languages, the "closed-class word" concept seems arbitrary. In other words: Which is the simplest rule to unequivocally, and without any exception, identify a closed-class word in English?

@wouterj
Copy link
Member

"a closed class (or closed word class) is a word class to which no new items can normally be added"http://en.wikipedia.org/wiki/Closed_class We might want to link to that wiki page instead

@weaverryan
Copy link
Member

Thanks Christian :). If we want to add a link to the closed class wiki, let's do it. Unfortunately, it'll never be totally clear and many people won't notice this anyways. Fortunately, it's not mission critical anyways. I've mostly been relying on@xabbuh for this - he really seems to understand it. Ideally, we'd have our own fabbot that just proposed a patch to fix your title.

@weaverryanweaverryan merged commit1fa40f3 intosymfony:2.3Jul 29, 2014
weaverryan added a commit that referenced this pull requestJul 29, 2014
…cles (xabbuh)This PR was merged into the 2.3 branch.Discussion----------[Cookbook] apply headline guidelines to the cookbook articles| Q             | A| ------------- | ---| Doc fix?      | yes| New docs?     | no| Applies to    | all| Fixed tickets |This completes the work started in#3765,#3828 and#3829.Commits-------1fa40f3 apply headline guidelines to the cookbook articles
@wouterj
Copy link
Member

I've mostly been relying on@xabbuh for this - he really seems to understand it.

I think it's better then to not show you#3894 (comment) and#3894 (comment) 😉

Ideally, we'd have our own fabbot that just proposed a patch to fix your title.

You'll have a Ryanbot in 2015. However, i think it'll be hard to teach this to a bot.

@xabbuhxabbuh deleted the headline-standards-cookbook branchJuly 29, 2014 16:28
@xabbuh
Copy link
MemberAuthor

Thanks Ryan. But yeah,@wouterj is right. There are some words or usages of words where we are not sure how to write them. Would be great to have your comment on them. :)

Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@xabbuh@javiereguiluz@wouterj@weaverryan

[8]ページ先頭

©2009-2025 Movatter.jp