On 28.06.19, 12:22, "Eike Ziller" <[email protected]> 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
> [email protected]
> https://lists.qt-project.org/listinfo/development
--
Eike Ziller
Principal Software Engineer
The Qt Company GmbH
Rudower Chaussee 13
D-12489 Berlin
[email protected]
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.
_______________________________________________
Development mailing list
[email protected]
https://lists.qt-project.org/listinfo/development
