Methods Documentation in WSDL

[Silvano Girardi Jr-2]

Hi all,
is there any special reason for the SCA to do not generate the <documentation></documentation> in the WSDL based on the method's description in the doc block?

Thanks,
Silvano

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[monxton]

Silvano Girardi Jr wrote:

> is there any special reason for the SCA to do not generate the
> <documentation></documentation> in the WSDL based on the method's
> description in the doc block?

Probably nobody thought to do it. Seems a good idea to me. Any volunteers?


--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Silvano Girardi Jr-2]

On Fri, Apr 25, 2008 at 5:38 AM, Caroline Maynard <cem@...> wrote:

Silvano Girardi Jr wrote:

> is there any special reason for the SCA to do not generate the
> <documentation></documentation> in the WSDL based on the method's
> description in the doc block?

Probably nobody thought to do it. Seems a good idea to me. Any volunteers?

I was checking how it works and it seems something I can handle in my spare time.

I will need to be in touch with someone here to discuss how we are going to do this.
Might be best in private and once we define the ways to do it we can put here in the list for votes. (Just thoughts really... not sure how you guys handle these things).

Anyway, I am a volunteer :)

Silvano

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[monxton]

Silvano Girardi Jr wrote:

> On Fri, Apr 25, 2008 at 5:38 AM, Caroline Maynard <cem@...> wrote:
>
>> Silvano Girardi Jr wrote:
>>
>>> is there any special reason for the SCA to do not generate the
>>> <documentation></documentation> in the WSDL based on the method's
>>> description in the doc block?
>> Probably nobody thought to do it. Seems a good idea to me. Any volunteers?
>>
>
> I was checking how it works and it seems something I can handle in my spare
> time.
>
> I will need to be in touch with someone here to discuss how we are going to
> do this.
> Might be best in private and once we define the ways to do it we can put
> here in the list for votes. (Just thoughts really... not sure how you guys
> handle these things).
>
> Anyway, I am a volunteer :)
>
> Silvano
>

Great :-)
Suggest you raise a Feature/Change Request at
http://pecl.php.net/bugs/report.php?package=SCA_SDO. Then when you have
a proposed patch we can get the relevant committers to review it.


--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Silvano Girardi Jr-2]

On Fri, Apr 25, 2008 at 12:28 PM, Caroline Maynard <cem@...> wrote:

Silvano Girardi Jr wrote:
> On Fri, Apr 25, 2008 at 5:38 AM, Caroline Maynard <cem@...> wrote:
>
>> Silvano Girardi Jr wrote:
>>
>>> is there any special reason for the SCA to do not generate the
>>> <documentation></documentation> in the WSDL based on the method's
>>> description in the doc block?
>> Probably nobody thought to do it. Seems a good idea to me. Any volunteers?
>>
>
> I was checking how it works and it seems something I can handle in my spare
> time.
>
> I will need to be in touch with someone here to discuss how we are going to
> do this.
> Might be best in private and once we define the ways to do it we can put
> here in the list for votes. (Just thoughts really... not sure how you guys
> handle these things).
>
> Anyway, I am a volunteer :)
>
> Silvano
>

Great :-)
Suggest you raise a Feature/Change Request at
http://pecl.php.net/bugs/report.php?package=SCA_SDO. Then when you have
a proposed patch we can get the relevant committers to review it.

Ok I just did it: http://pecl.php.net/bugs/bug.php?id=13775

Need your thoughts here.

1 - should it include the description of the service too (as I put in the request above), or only for methods?
2 - should it always happen or be optional? If optional, how to handle this?

Silvano

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Silvano Girardi Jr-2]

Since I got no comments, I made it only for methods and not optional.

I've put the patch in the case.

Silvano

On Fri, Apr 25, 2008 at 1:06 PM, Silvano Girardi Jr <silvanojr@...> wrote:

On Fri, Apr 25, 2008 at 12:28 PM, Caroline Maynard <cem@...> wrote:

Silvano Girardi Jr wrote:
> On Fri, Apr 25, 2008 at 5:38 AM, Caroline Maynard <cem@...> wrote:
>
>> Silvano Girardi Jr wrote:
>>
>>> is there any special reason for the SCA to do not generate the
>>> <documentation></documentation> in the WSDL based on the method's
>>> description in the doc block?
>> Probably nobody thought to do it. Seems a good idea to me. Any volunteers?
>>
>
> I was checking how it works and it seems something I can handle in my spare
> time.
>
> I will need to be in touch with someone here to discuss how we are going to
> do this.
> Might be best in private and once we define the ways to do it we can put
> here in the list for votes. (Just thoughts really... not sure how you guys
> handle these things).
>
> Anyway, I am a volunteer :)
>
> Silvano
>

Great :-)
Suggest you raise a Feature/Change Request at
http://pecl.php.net/bugs/report.php?package=SCA_SDO. Then when you have
a proposed patch we can get the relevant committers to review it.

Ok I just did it: http://pecl.php.net/bugs/bug.php?id=13775

Need your thoughts here.

1 - should it include the description of the service too (as I put in the request above), or only for methods?
2 - should it always happen or be optional? If optional, how to handle this?

Silvano

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Graham Charters-2]

Hi Silvano,

Sorry for not replying sooner and not replying to your original note.
I always had in mind to generate documentation in the WSDL from the
methods descriptions, so what you have done is exactly the right idea.

Thanks also for the patch.  I haven't taken a look at the moment.  The
SCA_SDO project has a CLA to cover contributions and so far as I'm
aware you've not signed, or been asked to sign it.  Is this something
you'd be willing and able to do?  I can give you more information in
needed.

Regards, Graham.

On 30 May, 17:05, "Silvano Girardi Jr" <silvan...@...> wrote:

> Since I got no comments, I made it only for methods and not optional.
>
> I've put the patch in the case.
>
> Silvano
>
> On Fri, Apr 25, 2008 at 1:06 PM, Silvano Girardi Jr <silvan...@...>
> wrote:
>
> > On Fri, Apr 25, 2008 at 12:28 PM, Caroline Maynard <c...@...> wrote:
>
> >> Silvano Girardi Jr wrote:
> >> > On Fri, Apr 25, 2008 at 5:38 AM, Caroline Maynard <c...@...> wrote:
>
> >> >> Silvano Girardi Jr wrote:
>
> >> >>> is there any special reason for the SCA to do not generate the
> >> >>> <documentation></documentation> in the WSDL based on the method's
> >> >>> description in the doc block?
> >> >> Probably nobody thought to do it. Seems a good idea to me. Any
> >> volunteers?
>
> >> > I was checking how it works and it seems something I can handle in my
> >> spare
> >> > time.
>
> >> > I will need to be in touch with someone here to discuss how we are going
> >> to
> >> > do this.
> >> > Might be best in private and once we define the ways to do it we can put
> >> > here in the list for votes. (Just thoughts really... not sure how you
> >> guys
> >> > handle these things).
>
> >> > Anyway, I am a volunteer :)
>
> >> > Silvano
>
> >> Great :-)
> >> Suggest you raise a Feature/Change Request at
> >>http://pecl.php.net/bugs/report.php?package=SCA_SDO. Then when you have
> >> a proposed patch we can get the relevant committers to review it.
>
> > Ok I just did it:http://pecl.php.net/bugs/bug.php?id=13775
>
> > Need your thoughts here.
>
> > 1 - should it include the description of the service too (as I put in the
> > request above), or only for methods?
> > 2 - should it always happen or be optional? If optional, how to handle
> > this?
>
> > Silvano

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Silvano Girardi Jr-2]

Hi Graham,
I have that interest. Where do I start? :)

Thanks
Silvano

On Mon, Jun 2, 2008 at 10:19 AM, Graham Charters <gcharters@...> wrote:

Hi Silvano,

Sorry for not replying sooner and not replying to your original note.
I always had in mind to generate documentation in the WSDL from the
methods descriptions, so what you have done is exactly the right idea.

Thanks also for the patch.  I haven't taken a look at the moment.  The
SCA_SDO project has a CLA to cover contributions and so far as I'm
aware you've not signed, or been asked to sign it.  Is this something
you'd be willing and able to do?  I can give you more information in
needed.

Regards, Graham.

On 30 May, 17:05, "Silvano Girardi Jr" <silvan...@...> wrote:
> Since I got no comments, I made it only for methods and not optional.
>
> I've put the patch in the case.
>
> Silvano
>

> On Fri, Apr 25, 2008 at 1:06 PM, Silvano Girardi Jr <silvan...@...>
> wrote:

>
> > On Fri, Apr 25, 2008 at 12:28 PM, Caroline Maynard <c...@...> wrote:
>
> >> Silvano Girardi Jr wrote:

> >> > On Fri, Apr 25, 2008 at 5:38 AM, Caroline Maynard <c...@...> wrote:
>
> >> >> Silvano Girardi Jr wrote:
>
> >> >>> is there any special reason for the SCA to do not generate the
> >> >>> <documentation></documentation> in the WSDL based on the method's
> >> >>> description in the doc block?
> >> >> Probably nobody thought to do it. Seems a good idea to me. Any
> >> volunteers?
>
> >> > I was checking how it works and it seems something I can handle in my
> >> spare
> >> > time.
>
> >> > I will need to be in touch with someone here to discuss how we are going
> >> to
> >> > do this.
> >> > Might be best in private and once we define the ways to do it we can put
> >> > here in the list for votes. (Just thoughts really... not sure how you
> >> guys
> >> > handle these things).
>
> >> > Anyway, I am a volunteer :)
>
> >> > Silvano
>
> >> Great :-)
> >> Suggest you raise a Feature/Change Request at
> >>http://pecl.php.net/bugs/report.php?package=SCA_SDO. Then when you have
> >> a proposed patch we can get the relevant committers to review it.
>
> > Ok I just did it:http://pecl.php.net/bugs/bug.php?id=13775
>
> > Need your thoughts here.
>
> > 1 - should it include the description of the service too (as I put in the
> > request above), or only for methods?
> > 2 - should it always happen or be optional? If optional, how to handle
> > this?
>
> > Silvano

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Graham Charters-2]

Hi Silvano,

There's a text document called "CLA" in the distirbution (see
http://cvs.php.net/viewvc.cgi/pecl/sdo/CLA?revision=1.2&view=markup&pathrev=MAIN).
It describes what you need to do.  If you have any questions or
concerns, please let me know.

Regards, Graham.

On 2 Jun, 16:53, "Silvano Girardi Jr" <silvan...@...> wrote:

> Hi Graham,
> I have that interest. Where do I start? :)
>
> Thanks
> Silvano
>
> On Mon, Jun 2, 2008 at 10:19 AM, Graham Charters <gchart...@...>
> wrote:
>
>
>
> > Hi Silvano,
>
> > Sorry for not replying sooner and not replying to your original note.
> > I always had in mind to generate documentation in the WSDL from the
> > methods descriptions, so what you have done is exactly the right idea.
>
> > Thanks also for the patch.  I haven't taken a look at the moment.  The
> > SCA_SDO project has a CLA to cover contributions and so far as I'm
> > aware you've not signed, or been asked to sign it.  Is this something
> > you'd be willing and able to do?  I can give you more information in
> > needed.
>
> > Regards, Graham.
>
> > On 30 May, 17:05, "Silvano Girardi Jr" <silvan...@...> wrote:
> > > Since I got no comments, I made it only for methods and not optional.
>
> > > I've put the patch in the case.
>
> > > Silvano
>
> > > On Fri, Apr 25, 2008 at 1:06 PM, Silvano Girardi Jr <silvan...@...
>
> > > wrote:
>
> > > > On Fri, Apr 25, 2008 at 12:28 PM, Caroline Maynard <c...@...>
> > wrote:
>
> > > >> Silvano Girardi Jr wrote:
> > > >> > On Fri, Apr 25, 2008 at 5:38 AM, Caroline Maynard <c...@...>
> > wrote:
>
> > > >> >> Silvano Girardi Jr wrote:
>
> > > >> >>> is there any special reason for the SCA to do not generate the
> > > >> >>> <documentation></documentation> in the WSDL based on the method's
> > > >> >>> description in the doc block?
> > > >> >> Probably nobody thought to do it. Seems a good idea to me. Any
> > > >> volunteers?
>
> > > >> > I was checking how it works and it seems something I can handle in
> > my
> > > >> spare
> > > >> > time.
>
> > > >> > I will need to be in touch with someone here to discuss how we are
> > going
> > > >> to
> > > >> > do this.
> > > >> > Might be best in private and once we define the ways to do it we can
> > put
> > > >> > here in the list for votes. (Just thoughts really... not sure how
> > you
> > > >> guys
> > > >> > handle these things).
>
> > > >> > Anyway, I am a volunteer :)
>
> > > >> > Silvano
>
> > > >> Great :-)
> > > >> Suggest you raise a Feature/Change Request at
> > > >>http://pecl.php.net/bugs/report.php?package=SCA_SDO. Then when you
> > have
> > > >> a proposed patch we can get the relevant committers to review it.
>
> > > > Ok I just did it:http://pecl.php.net/bugs/bug.php?id=13775
>
> > > > Need your thoughts here.
>
> > > > 1 - should it include the description of the service too (as I put in
> > the
> > > > request above), or only for methods?
> > > > 2 - should it always happen or be optional? If optional, how to handle
> > > > this?
>
> > > > Silvano

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa@...
To unsubscribe from this group, send email to phpsoa-unsubscribe@...
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---