<table><tr><td style="">aaronpuchert added a comment.
</td><a style="text-decoration: none; padding: 4px 8px; margin: 0 8px 8px; float: right; color: #464C5C; font-weight: bold; border-radius: 3px; background-color: #F7F7F9; background-image: linear-gradient(to bottom,#fff,#f1f0f1); display: inline-block; border: 1px solid rgba(71,87,120,.2);" href="https://phabricator.kde.org/D8211" rel="noreferrer">View Revision</a></tr></table><br /><div><div><blockquote style="border-left: 3px solid #8C98B8;
          color: #6B748C;
          font-style: italic;
          margin: 4px 0 12px 0;
          padding: 8px 12px;
          background-color: #F8F9FC;">
<div style="font-style: normal;
          padding-bottom: 4px;">In <a href="https://phabricator.kde.org/D8211#157186" style="background-color: #e7e7e7;
          border-color: #e7e7e7;
          border-radius: 3px;
          padding: 0 4px;
          font-weight: bold;
          color: black;text-decoration: none;" rel="noreferrer">D8211#157186</a>, <a href="https://phabricator.kde.org/p/kossebau/" style="
              border-color: #f1f7ff;
              color: #19558d;
              background-color: #f1f7ff;
                border: 1px solid transparent;
                border-radius: 3px;
                font-weight: bold;
                padding: 0 4px;" rel="noreferrer">@kossebau</a> wrote:</div>
<div style="margin: 0;
          padding: 0;
          border: 0;
          color: rgb(107, 116, 140);"><p>And "more advanced rendering code" still makes sense in an integrated development environment, at least to me, I see rendering power orthogonal to being part of IDE. Actually I consider a separate general browser application an inferior solution, as it does not allow to be properly integrated into kdevelop project/session management (project/session specific bookmarks, browsing history, tight control about location in UI etc).</p></div>
</blockquote>

<p>Just my two cents: I don't care that much about bookmarks or having the documentation within the IDE itself. I consider the most important feature that I can hover over a function in the code, do one click and directly get to the documentation, without copying the name, without typing anything.</p>

<p>The main reason why the integrated viewer makes sense for me is to view man pages, which I can't view in the browser. At least not offline. So that is nice. Not only because I don't have to type <tt style="background: #ebebeb; font-size: 13px;">man ...</tt> in the terminal, but also because it looks nicer than on a terminal. But fully-fledged HTML docs, possibly with advanced CSS and JavaScript? I don't see any reason to not use an external web browser. Browsers are specialized to display web pages, and it's really hard to do a better job there, regarding the actual display, interactivity, or additional features like bookmarks and history.</p>

<p>For me the purpose of integrating something is not to avoid leaving the window, but to streamline the workflow. Take compilation as an example: when there's an error, I click on it and get to the piece of code that caused it. This makes fixing compiler errors a lot easier compared to compiling from the terminal. Similar for debugging: I find a mistake, and fix it directly. I don't need to search for a file and scroll to the problematic line, I'm already there.</p>

<p>But what is the value of integrating documentation, apart from not having to leave the window? The integration with the code: being able to quickly get the documentation for a piece of API I'm using. But that doesn't exclude using an external application to actually view the documentation.</p>

<p>I'm getting a bit off-topic here, so to sum it up: Regardless of the technical merits of QWE and QWK, I don't see a problem with having a somewhat simplified documentation renderer within KDevelop itself, possibly referring to external applications when it gets too hard.</p></div></div><br /><div><strong>REPOSITORY</strong><div><div>R32 KDevelop</div></div></div><br /><div><strong>REVISION DETAIL</strong><div><a href="https://phabricator.kde.org/D8211" rel="noreferrer">https://phabricator.kde.org/D8211</a></div></div><br /><div><strong>To: </strong>rjvbb, KDevelop<br /><strong>Cc: </strong>croick, kossebau, aaronpuchert, flherne, arichardson, apol, kdevelop-devel, geetamc, Pilzschaf, akshaydeo, surgenight, arrowdodger<br /></div>