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
