Please do not make any massive help page changes after beta1 release of
7.2, because that makes it hard to be localized in time for a 7.2 release.
The 7.2 release in itself requires a big effort from the l10n community
with many new help strings and help updates.
Lp, m.
V V tor., 8. jun. 2021 ob 22:24 je oseba Rafael Lima <
rafael.palma.l...@gmail.com> napisala:
> 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
>
--
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
