[Development] Assistant WebKit/WebEngine support

[Eike Ziller]

> On 24. Jun 2019, at 11:42, Palaraja, Kavindra <KPalaraja at luxoft.com> wrote:
> 
> 
> On 24.06.19, 11:20, "Eike Ziller" <Eike.Ziller at qt.io> wrote:
> 
> ..
> 
>> Have you seen Qt Creator's Help Integration recently?
>> * It doesn't render 1:1 with the default style that is used on https://doc.qt.io
> 
>    Yes, the style has to be changed for QTextBrowser. Partly that is a limitation of QTextBrowser (like the issues below), partly offline documentation integrated into an application should look different than the online variant anyhow (like not having the Google search).
> 
>> * It can't display the borders for tables -  so every single table looks weird as all borders are stripped out. Qt's documentation is full of tables.
>> * It doesn't scale images accordingly, so you have manually guess what Creator can display and try really hard to shrink your diagrams without losing clarity
>> 
>> Is this really what we want to showcase to our customers?
> 
>    Well, what I’d really like would be a lightweight RichText / HTML+CSS viewer without all the baggage of a complete internet browser. QTextBrowser does too little, QtWebEngine much too much.
> 
>    Br, Eike
> 
> Hi Eike,
> 
> OK, so WebEngine is large and we'd like something better? Sounds good. Where do we find this lightweight solution that provides the middle ground we need?
> 
> Two further questions:
> 
> * What exactly is so big about WebEngine? What is this size that many are hinting at but won't provide the number?

My numbers on macOS:

WebEngineCore.framework = 145 MB
Current Qt Creator application = 430 MB (and about 60 MB of this we currently try to get rid off again because it’s actually duplicate binary code)

> * Doesn't WebEngine have a feature where you can completely lock it out of the Internet?
> 
> Additionally, I disagree with the style being different between offline & online documentation. This difference breaks the Qt developer experience currently. We certainly should remove the Google Search for Creator, but the color, style, layout etc. that is on https://doc.qt.io provides the identity for the Qt Brand and should be identical to what we see in Creator's documentation. This is what people mean when they say "seamless integration". Whether the viewer is connected to the big bad Internet, is another story.
> 
> It's hard enough to get developers to update their documentation when they make code changes. Adding in this dependency that what they change may not look the way they intended it to look like -- because the output from "make docs" actually gives you yet another style

“make docs” gives you the content & style that is rendered in the application. The difference is which application you use to view it (and I’d prefer if this would not much differ, but not for any price).

> -- is overkill. So we now have 3 different documentation styles for 1 development toolkit's documentation.
> 
> 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