Hi Steve,
I agree with you. There's no rush to make a decision on this topic. It'll
be a great topic for discussion in the upcoming meeting.
However I haven't been able to attend our Thursdays meetings due to other
appointments I have at work. Hope I'll be able to attend the next one.
Cheers,
Rafael
On Tue, Jun 8, 2021 at 4:58 PM Steve Fanning <stevefann...@libreoffice.org>
wrote:
> Hi Rafael,
>
> With regards to differences between the Calc Functions Wiki and the
> corresponding Help pages...
>
> You are correct that there is currently a significant difference in the
> content of the help pages and the wiki pages for SOME of Calc's
> functions. We need to work out how the users can be made aware of the
> extra content on the wiki but I don't think there is a great rush to
> solve this particular issue. We should give possible solutions some
> proper thought before making any changes to the help; meanwhile we will
> continue to improve the 500+ wiki pages.
>
> Perhaps we could discuss at a future Documentation Team meeting? (After
> this week I expect to be able to attend our Thursday evening meetings a
> little more frequently).
>
> Regards,
>
> Steve
>
>
> On 08/06/2021 18:43, Rafael Lima wrote:
> > Hi Steve,
> >
> > I have just read the three wiki pages you mentioned and I could not find
> > any issues with them. IMO they're very thorough and well written.
> >
> > In the WEBSERVICE page, section "Accessing non-XML data", I would add the
> > following:
> >
> > ----------------------
> > The WEBSERVICE function returns the raw result from an HTTP/ HTTPS
> request.
> > Hence, if the URI address corresponds to any type of text content (e.g.
> > CSV, XML, TXT, MD, etc), the raw content will be returned and stored in
> the
> > cell.
> > The example below will return the raw contents of the file README.md
> stored
> > in the given URI.
> > =WEBSERVICE("https://opengrok.libreoffice.org/download/help/README.md";)
> > ----------------------
> >
> > The wiki pages for FILTERXML and ENCODEURL are perfect!
> >
> > BTW, there's a huge difference between the Help contents and the wiki
> > (which is far more complete) and I fear that some users may not find all
> > the contents they look for in the help pages. Do you think we could add
> > links in the help pages referencing the corresponding wiki pages?
> >
> > For example:
> > To learn more refer to the WEBSERVICE wiki page. (with a link to the wiki
> > pages)
> >
> > Regards,
> > Rafael Lima
> >
> > On Sun, Jun 6, 2021 at 4:11 PM Steve Fanning <
> stevefann...@libreoffice.org>
> > wrote:
> >
> >> Hello All,
> >>
> >> Please could somebody with technical knowledge of these three functions
> >> help me?
> >>
> >> I have been upgrading their descriptions in the Calc Functions Wiki area
> >> (
> >>
> https://wiki.documentfoundation.org/Documentation/Calc_Functions/ENCODEURL
> ,
> >>
> >>
> https://wiki.documentfoundation.org/Documentation/Calc_Functions/FILTERXML
> >> and
> >>
> https://wiki.documentfoundation.org/Documentation/Calc_Functions/WEBSERVICE
> >> ).
> >>
> >> I am not an expert on these functions but have extended the descriptions
> >> beyond the explanations given in the Help by a combination of code
> >> inspection and experimentation.
> >>
> >> Would it be possible for somebody who has expertise in this area to
> >> review these three wiki pages from a technical perspective? Is what I
> >> have written technically correct? Have I missed anything that might be
> >> significant to a user who is looking for more background? (Please don't
> >> think I'm looking for somebody to find typos - there may be some, but we
> >> can resolve those without wasting any of a developer's valuable time!)
> >>
> >> On a specific point, do we need to declare the versions of XML and XPath
> >> that are relevant for FILTERXML? If so, can somebody confirm what they
> are?
> >>
> >> Thanks in advance.
> >>
> >> Regards,
> >>
> >> Steve Fanning (LibreOffice Documentation Team)
> >>
> >>
> >>
> >> --
> >> To unsubscribe e-mail to:
> documentation+unsubscr...@global.libreoffice.org
> >> Problems?
> >> https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
> >> Posting guidelines + more:
> https://wiki.documentfoundation.org/Netiquette
> >> List archive:
> https://listarchives.libreoffice.org/global/documentation/
> >> Privacy Policy: https://www.documentfoundation.org/privacy
> >>
>
> --
> To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
> Problems?
> https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
> Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
> List archive: https://listarchives.libreoffice.org/global/documentation/
> Privacy Policy: https://www.documentfoundation.org/privacy
>
--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy
