Skip to content

[WIP] re-read of http-foundation component docs #2435

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

Merged
merged 12 commits into from
Jun 12, 2013

Conversation

joelclermont
Copy link
Contributor

Q A
Doc fix? yes
New docs? yes
Applies to 2.1+
Fixed tickets #2395

Just getting started, but I wanted to submit some example commits as a WIP for early feedback. I'm also posting some questions/comments in the issue thread.


* ``server``: equivalent of ``$_SERVER``;

* ``headers``: mostly equivalent to a sub-set of ``$_SERVER``
(``$request->headers->get('Content-Type')``).
(``$request->headers->get('user-agent')``).
Copy link
Member

Choose a reason for hiding this comment

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

Both are correct IMO

Copy link
Contributor Author

Choose a reason for hiding this comment

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

You're right. Content-type could be used on a POST or PUT. Might I suggest that user-agent still could be a better choice since all requests are likely to have this. If someone is trying out code samples, they might be confused why content-type is coming up null. What do you think?

Copy link
Member

Choose a reason for hiding this comment

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

Both are good, so I'm cool with user agent. But I think we should have it be User-Agent - it's true that case doesn't matter when getting the headers, but User-Agent may be a little more recognizable as a header.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ok, I will make the change. I'm also planning on picking this back up over the weekend to finish the WIP. Thanks for the feedback.

@weaverryan
Copy link
Member

Ping @joelclermont! Let me know what your plans are with this - you already have some nice changes here.

Cheers!

@joelclermont
Copy link
Contributor Author

Wow, time has gotten away from me. My plan is to finish up the doc review completely, hopefully in the next week. Thanks for the reminder.

weaverryan added a commit that referenced this pull request Jun 12, 2013
[WIP] re-read of http-foundation component docs
@weaverryan weaverryan merged commit d3d25d0 into symfony:2.1 Jun 12, 2013
@weaverryan
Copy link
Member

Hey Joel!

I've merged this in because you had a lot of nice changes :). I know you wanted to do a bit more and hopefully someday you will ;). Thanks again for joining us during the doc-day.

Cheers!

@joelclermont
Copy link
Contributor Author

Thanks Ryan. Let me know when the next doc day is and I'd love to participate. I'm still trying to carve out more time in between 😄

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.

3 participants