Re: STH Docs.
| From: | Pasindu De Silva | Date: | Sat, 16 May 2015 07:20:17 +0000 |
| Subject: | Re: STH Docs. | ||
| References: | 1 2 3 4 5 6 7 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969385654@lists.php.net to get a copy of this message | ||
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>*