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
