Add additional documentation on Headers#[] [ci skip]
Add additional documentation on Headers#[] [ci skip]

Issue #16519 covers confusion potentially caused by how HTTP
headers, that contain underscores in their names, are retrieved
through `ActionDispatch::Http::Headers#[]`.

This confusion has its origin in how a CGI maps HTTP header names
to variable names. Even though underscores in header names
are rarely encountered, they are valid according to RFC822 [1].
Nonetheless CGI like variable names, as requested by the Rack
specfication, will only contain underscores and therefore the
original header name cannot be recovered after the Rack server passed
on the environemnt hash. Please, see also the disscussion on
StackOverflow [2], which also links to an explaination in the
nginx documentation [3].

[1] http://www.ietf.org/rfc/rfc822.txt
[2] http://stackoverflow.com/questions/22856136/why-underscores-are-forbidden-in-http-header-names
[3] https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/#missing-disappearing-http-headers

arunagw/rails,flanger001/rails,gfvcastro/rails,kmcphillips/rails,flanger001/rails,gavingmiller/rails,gfvcastro/rails,iainbeeston/rails,vipulnsward/rails,hanystudy/rails,esparta/rails,shioyama/rails,marklocklear/rails,richseviora/rails,Envek/rails,illacceptanything/illacceptanything,shioyama/rails,pvalena/rails,gfvcastro/rails,maicher/rails,elfassy/rails,mathieujobin/reduced-rails-for-travis,rossta/rails,Edouard-chin/rails,rafaelfranca/omg-rails,illacceptanything/illacceptanything,travisofthenorth/rails,Stellenticket/rails,kenta-s/rails,vipulnsward/rails,bradleypriest/rails,starknx/rails,BlakeWilliams/rails,baerjam/rails,eileencodes/rails,yasslab/railsguides.jp,betesh/rails,illacceptanything/illacceptanything,illacceptanything/illacceptanything,deraru/rails,schuetzm/rails,palkan/rails,betesh/rails,arunagw/rails,Envek/rails,ngpestelos/rails,samphilipd/rails,ttanimichi/rails,ledestin/rails,sealocal/rails,MSP-Greg/rails,prathamesh-sonpatki/rails,lcreid/rails,illacceptanything/illacceptanything,flanger001/rails,yawboakye/rails,voray/rails,vipulnsward/rails,Vasfed/rails,rossta/rails,coreyward/rails,mechanicles/rails,yalab/rails,repinel/rails,illacceptanything/illacceptanything,alecspopa/rails,starknx/rails,gcourtemanche/rails,mtsmfm/railstest,yawboakye/rails,kddeisz/rails,lcreid/rails,alecspopa/rails,pvalena/rails,gauravtiwari/rails,utilum/rails,shioyama/rails,EmmaB/rails-1,tgxworld/rails,arjes/rails,fabianoleittes/rails,odedniv/rails,mtsmfm/rails,lcreid/rails,rails/rails,sergey-alekseev/rails,tijwelch/rails,Erol/rails,kirs/rails-1,yahonda/rails,Spin42/rails,illacceptanything/illacceptanything,gcourtemanche/rails,voray/rails,mechanicles/rails,baerjam/rails,mtsmfm/rails,mohitnatoo/rails,betesh/rails,sealocal/rails,Vasfed/rails,joonyou/rails,fabianoleittes/rails,vassilevsky/rails,deraru/rails,tijwelch/rails,jeremy/rails,travisofthenorth/rails,rbhitchcock/rails,esparta/rails,koic/rails,voray/rails,assain/rails,MSP-Greg/rails,odedniv/rails,notapatch/rails,samphilipd/rails,EmmaB/rails-1,ttanimichi/rails,vassilevsky/rails,Vasfed/rails,jeremy/rails,arjes/rails,yhirano55/rails,kamipo/rails,kamipo/rails,riseshia/railsguides.kr,felipecvo/rails,matrinox/rails,untidy-hair/rails,tjschuck/rails,pschambacher/rails,georgeclaghorn/rails,xlymian/rails,stefanmb/rails,ngpestelos/rails,illacceptanything/illacceptanything,mechanicles/rails,palkan/rails,flanger001/rails,illacceptanything/illacceptanything,maicher/rails,yasslab/railsguides.jp,koic/rails,mtsmfm/railstest,EmmaB/rails-1,maicher/rails,georgeclaghorn/rails,coreyward/rails,rafaelfranca/omg-rails,schuetzm/rails,kmayer/rails,repinel/rails,xlymian/rails,bolek/rails,printercu/rails,riseshia/railsguides.kr,illacceptanything/illacceptanything,stefanmb/rails,betesh/rails,kmayer/rails,Stellenticket/rails,amoody2108/TechForJustice,Stellenticket/rails,printercu/rails,fabianoleittes/rails,rbhitchcock/rails,MichaelSp/rails,untidy-hair/rails,tgxworld/rails,hanystudy/rails,ledestin/rails,travisofthenorth/rails,pvalena/rails,amoody2108/TechForJustice,iainbeeston/rails,felipecvo/rails,brchristian/rails,yawboakye/rails,kddeisz/rails,mtsmfm/railstest,utilum/rails,mathieujobin/reduced-rails-for-travis,georgeclaghorn/rails,kirs/rails-1,mtsmfm/rails,lucasmazza/rails,Spin42/rails,brchristian/rails,assain/rails,bolek/rails,tjschuck/rails,mohitnatoo/rails,Edouard-chin/rails,esparta/rails,kenta-s/rails,aditya-kapoor/rails,schuetzm/rails,matrinox/rails,utilum/rails,marklocklear/rails,yahonda/rails,gavingmiller/rails,alecspopa/rails,yasslab/railsguides.jp,tgxworld/rails,mijoharas/rails,Sen-Zhang/rails,Sen-Zhang/rails,arunagw/rails,Envek/rails,kachick/rails,yahonda/rails,kaspth/rails,yalab/rails,rails/rails,jeremy/rails,koic/rails,bogdanvlviv/rails,fabianoleittes/rails,kmcphillips/rails,BlakeWilliams/rails,illacceptanything/illacceptanything,repinel/rails,printercu/rails,gavingmiller/rails,MSP-Greg/rails,tjschuck/rails,tjschuck/rails,repinel/rails,prathamesh-sonpatki/rails,yhirano55/rails,notapatch/rails,untidy-hair/rails,untidy-hair/rails,rafaelfranca/omg-rails,deraru/rails,eileencodes/rails,illacceptanything/illacceptanything,kamipo/rails,hanystudy/rails,kddeisz/rails,Sen-Zhang/rails,kmayer/rails,joonyou/rails,riseshia/railsguides.kr,richseviora/rails,pvalena/rails,bolek/rails,sealocal/rails,schuetzm/rails,kmcphillips/rails,yalab/rails,rbhitchcock/rails,baerjam/rails,Erol/rails,notapatch/rails,bogdanvlviv/rails,assain/rails,baerjam/rails,utilum/rails,kaspth/rails,illacceptanything/illacceptanything,yalab/rails,gcourtemanche/rails,aditya-kapoor/rails,Spin42/rails,BlakeWilliams/rails,starknx/rails,vipulnsward/rails,felipecvo/rails,printercu/rails,marklocklear/rails,aditya-kapoor/rails,bradleypriest/rails,iainbeeston/rails,notapatch/rails,kmcphillips/rails,ngpestelos/rails,mijoharas/rails,kachick/rails,Erol/rails,mohitnatoo/rails,jeremy/rails,coreyward/rails,Vasfed/rails,BlakeWilliams/rails,bogdanvlviv/rails,Stellenticket/rails,pschambacher/rails,odedniv/rails,prathamesh-sonpatki/rails,amoody2108/TechForJustice,mijoharas/rails,sergey-alekseev/rails,yasslab/railsguides.jp,assain/rails,MichaelSp/rails,tgxworld/rails,bogdanvlviv/rails,Edouard-chin/rails,kachick/rails,bradleypriest/rails,eileencodes/rails,ledestin/rails,lucasmazza/rails,arjes/rails,mathieujobin/reduced-rails-for-travis,mohitnatoo/rails,tijwelch/rails,brchristian/rails,yhirano55/rails,Edouard-chin/rails,mechanicles/rails,elfassy/rails,Erol/rails,kddeisz/rails,yhirano55/rails,gauravtiwari/rails,MSP-Greg/rails,sergey-alekseev/rails,gfvcastro/rails,georgeclaghorn/rails,shioyama/rails,illacceptanything/illacceptanything,richseviora/rails,palkan/rails,samphilipd/rails,joonyou/rails,arunagw/rails,xlymian/rails,rossta/rails,yahonda/rails,rails/rails,illacceptanything/illacceptanything,vassilevsky/rails,lcreid/rails,riseshia/railsguides.kr,palkan/rails,esparta/rails,lucasmazza/rails,pschambacher/rails,deraru/rails,joonyou/rails,prathamesh-sonpatki/rails,rails/rails,eileencodes/rails,matrinox/rails,gauravtiwari/rails,kenta-s/rails,iainbeeston/rails,aditya-kapoor/rails,yawboakye/rails,kirs/rails-1,Envek/rails,stefanmb/rails,ttanimichi/rails,kaspth/rails,elfassy/rails,travisofthenorth/rails,MichaelSp/rails