Thanks Robbie and Chuck for the pointers! Il giorno sab 13 ott 2018 alle ore 17:01 Chuck Burgess <[email protected]> ha scritto:
> Regarding #1, please join the discussion at > https://github.com/phpDocumentor/fig-standards/pull/81 > CRB > *about.me/ashnazg <http://about.me/ashnazg>* > > > On Sat, Oct 13, 2018 at 9:32 AM Marco Perone <[email protected]> wrote: > >> Hi, >> >> I would like to share some (not very refined) ideas regarding the usage >> of PHPDoc annotations, to see if they can be of any interest. Since I am >> quite a fan of types, they all concern the ability of expressing typing >> information in the documentation. >> >> 1) One desirable feature which is missing from the language is the use of >> generics. It would be nice to provide their usage at the level of >> documentation. This is already possible for arrays with the `[]` notation. >> It would be nice to be able to write something like `Collection<User>` to >> denote that the collection contains `User` objects >> >> 2) Another great limitation in the PHP type system is the impossibility >> to type input and return types of callables. At the moment `callable` is >> the best documentation which can be provided. It would be nice to introduce >> a syntax like `callable: User -> string` to document the actual type of the >> callable. >> >> 3) Define the usage of type variables at the level of documentation. This >> would allow to declare that the types of two different entities are >> related. For example, one could desire to express that two variables need >> to have the same type, or that a callable should receive an input of the >> same type of another variable. >> >> Marco Perone >> >> >> -- >> You received this message because you are subscribed to the Google Groups >> "PHP Framework Interoperability Group" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected]. >> To post to this group, send email to [email protected]. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/php-fig/8984c673-629a-40f1-91f3-0d385a5efddb%40googlegroups.com >> <https://groups.google.com/d/msgid/php-fig/8984c673-629a-40f1-91f3-0d385a5efddb%40googlegroups.com?utm_medium=email&utm_source=footer> >> . >> For more options, visit https://groups.google.com/d/optout. >> > -- > You received this message because you are subscribed to a topic in the > Google Groups "PHP Framework Interoperability Group" group. > To unsubscribe from this topic, visit > https://groups.google.com/d/topic/php-fig/vQfOntge-10/unsubscribe. > To unsubscribe from this group and all its topics, send an email to > [email protected]. > To post to this group, send email to [email protected]. > To view this discussion on the web visit > https://groups.google.com/d/msgid/php-fig/CANsgjntOZC0qrxg%2BZ%3DVxc__RmZc%2BR9CvK41D3GtnhcaBb%3DpRtg%40mail.gmail.com > <https://groups.google.com/d/msgid/php-fig/CANsgjntOZC0qrxg%2BZ%3DVxc__RmZc%2BR9CvK41D3GtnhcaBb%3DpRtg%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > For more options, visit https://groups.google.com/d/optout. > -- Marco Perone @marcoshuttle <https://twitter.com/marcoshuttle> https://github.com/marcosh http://marcosh.github.io/ -- You received this message because you are subscribed to the Google Groups "PHP Framework Interoperability Group" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/php-fig/CAARDrK8atf2ZTu5K6%3Dbwmp58%3Dd1SjT6eZ1O_8_yLSB5-yFVMsA%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
