Re: STH Docs.

On 18 May 2015 at 12:45, Pasindu De Silva <ppasindud@gmail.com> wrote: > Hi Guys > I have patched the intial doc for Scalar Type Declarations, and making > "scalar typed parameters" a placeholder, which could be replaced > when we have some consensus on the wording. so we can carry with the > documenting the rest. > Could you attach the patch here? > > +1 > Pasindu > > On Sat, May 16, 2015 at 12:50 PM, Pasindu De Silva <ppasindud@gmail.com> > wrote: > >> Guys, >> do we have a consensus on whether type hinting has to be changed >> to Parameter Typing or Typed Parameters or else left the same. >> The scalar docs can go under >> http://php.net/manual/en/language.types.php >> >> If we are going the change then for oop5.typehinting >> We could clone "language.oop5.typehinting" to be >> "language.types.other-typed-parameters" and put a warning on oop5.typehinting >> about the change >> later change things that are linked to oop5.typehinting to >> types.other-typed-parameters. >> >> +1 >> Thanks >> >> On Thu, Apr 30, 2015 at 9:32 PM, Hannes Magnusson <bjori@php.net> wrote: >> >>> Its difficult to redirect all translations of an page too. >>> >>> Historically we try to refer to the shorturl >>> (http://php.net/oop5.typehinting) as that will do automatic language >>> negotiation, in which case we only need to keep an errorhandler >>> redirect for one entry. >>> >>> Our policy is to never rename/remove xml:ids of chunks. >>> The best thing to do is to keep that xml:id for historical description >>> (if that route is taken), and then we at least have the ID on file and >>> might be able to do reasonable fallback to its container. >>> >>> Keep in mind that translations will not break if they have translated >>> langauge/oop5.xml, and will include the current typehint page for a >>> long long time, unless there is a reference to the new xml:id outside >>> of the same hierarchy. >>> >>> This is a tricky thing to be doing and translators should likely be >>> notified of the changes once they are done. >>> >>> -Hannes >>> >>> >>> On Wed, Apr 29, 2015 at 4:37 AM, Pasindu De Silva <ppasindud@gmail.com> >>> wrote: >>> > Thanks for the info, >>> > If the redirection of >>> http://php.net/manual/en/language.oop5.typehinting.php >>> > is done, not sure whether >>> > it have effects on other languages maybe not. >>> > >>> >> Levi Morrison wrote: >>> >> > - Please don't use the phrase "type hint" anywhere >>> > >>> > >>> > some other suggestions would be helpful. >>> > >>> > -- >>> > Pasindu De Silva >>> > ppasindud@gmail.com >>> >> >> >> >> -- >> >> *Pasindu De Silva**ppasindud@gmail.com <ppasindud@gmail.com>* >> > > > > -- > > *Pasindu De Silva**ppasindud@gmail.com <ppasindud@gmail.com>* >