[Development] Assistant WebKit/WebEngine support

Palaraja, Kavindra KPalaraja at luxoft.com
Fri Jun 28 14:46:44 CEST 2019


On 28.06.19, 12:22, "Eike Ziller" <Eike.Ziller at qt.io> wrote:

....

    > From your response, I'm only gathering two options:

    There are other options.
    https://lists.qt-project.org/pipermail/development/2019-June/036712.html
    summarizes many of them.
    Additionally “strip down QtWebEngine or QtWebKit and support that”.
    Or, separating "plain and simple API documentation" to be displayed directly an Qt Creator/Assistant from “fancy tutorials” to be displayed by a browser of the user’s choice.

Just curious, how would you define "plain and simple API documentation"?

Developer documentation is split up into four categories:

* API Reference -- the inline source code comments
* Conceptual documentation -- The qdoc files that we use to explain how to use large modules
* Code samples -- The snippets and the Examples
* Strings -- error messages and Creator's strings

Right now, with qdoc, all we have is "plain and simple API documentation", the first three categories. None of this is fancy yet Creator/Assistant can't display it correctly.

    > 1. Live with it and hope that somehow this will solve itself in the future -- there is no evidence from the past years that this is going to happen. Recall that the ticket we are still debating over is from March 2016.

    > 2. Give QtWebEngine at least a try, let the users decide in a BETA phase.

    - a tiny percentage of users use Betas
    - there already is quite some controversy in this email thread

I don’t see why this should be a controversy. I understand and empathize with the reaction from some of the community members, but I think as people who have worked in this product and industry for a while, we should be able to discuss this in a respectful, professional, clear headed manner.

    Br, Eike

    > Kavindra.
    >
    >
    > ________________________________
    >
    > This e-mail and any attachment(s) are intended only for the recipient(s) named above and others who have been specifically authorized to receive them. They may contain confidential information. If you are not the intended recipient, please do not read this email or its attachment(s). Furthermore, you are hereby notified that any dissemination, distribution or copying of this e-mail and any attachment(s) is strictly prohibited. If you have received this e-mail in error, please immediately notify the sender by replying to this e-mail and then delete this e-mail and any attachment(s) or copies thereof from your system. Thank you.
    > _______________________________________________
    > Development mailing list
    > Development at qt-project.org
    > https://lists.qt-project.org/listinfo/development

    --
    Eike Ziller
    Principal Software Engineer

    The Qt Company GmbH
    Rudower Chaussee 13
    D-12489 Berlin
    eike.ziller at qt.io
    http://qt.io
    Geschäftsführer: Mika Pälsi,
    Juha Varelius, Mika Harjuaho
    Sitz der Gesellschaft: Berlin, Registergericht: Amtsgericht Charlottenburg, HRB 144331 B




________________________________

This e-mail and any attachment(s) are intended only for the recipient(s) named above and others who have been specifically authorized to receive them. They may contain confidential information. If you are not the intended recipient, please do not read this email or its attachment(s). Furthermore, you are hereby notified that any dissemination, distribution or copying of this e-mail and any attachment(s) is strictly prohibited. If you have received this e-mail in error, please immediately notify the sender by replying to this e-mail and then delete this e-mail and any attachment(s) or copies thereof from your system. Thank you.


More information about the Development mailing list