Version 2 (modified by Henry Haverinen, 12 years ago) (diff)


Contributing documentation to QtWebKit

UNDER CONSTRUCTION! This wiki page contains the information that is relevant for technical writers contributing documentation to QtWebKit.

QtWebKit comes with extensive documentation for C++ developers, and we'd like to extend the documentation also for web developers.

The documentation sources are in qdoc format, stored together with the source code in the WebKit SVN. Documentation contributions are submitted to the project similarly as source code contributions -- for instance, documentation changes need to be reviewed before they are committed.

The C++ API documentation is included in line in the C++ source files. Standalone documentation articles are in the WebKit/qt/docs directory.

The qdoc markup is a simple wiki-like format. The qdoc tool is documented here: For Windows users, the easiest way to get the qdoc3 command line tool is to install the Qt SDK for Windows and add the bin directory to the PATH.

Checking out the sources

Since the documentation is stored together with the source code, also technical writes need to check out the sources. In this wiki, we describe how to do this using the public git repository hosted at This is a mirror of the WebKit SVN repository.

git clone git://

To see the remote branches you just fetched do:

git branch -r

For the tags simply do:

git tag

And to switch to a branch or a tag simply use git checkout

Submitting a documentation contribution

When using the git repository to access the sources, the steps to submit a patch are roughly as follows. Please see the WebKit project's page about contributing for more information.

  • Make your changes in the webkit source code directory. Typically, you would change existing qdoc files or create new qdoc files.
  • Run the WebKitTools/Scripts/prepare-ChangeLog script to create an entry for your changes in each relevant ChangeLog file.
  • Edit the ChangeLog files reported by the prepare-ChangeLog script:
    • If you work on a task without bug report on yet, create a bug report. Use the severity "Enhancement" if your patch is an improvement and not related to a bug.
    • Add a short description and paste the bug URL below it. Add an extra line and a detailed description if necessary.
    • Precede the short description with "[Qt]" since your documentation patch is specific to the Qt port of WebKit.
    • The description text should be the same in all ChangeLog files.
    • Keep the "Reviewed by NOBODY (OOPS!)." line in the ChangeLog files, it will be edited by the bot or person that will commit your fix.
  • Do a git diff > patchname.patch to create your patch (use --cached if you first did a git add to put your changes in the git index)
  • Attach the patch to the bug report, set the review flag to '?' and the commit-queue flag to '?'
  • Wait :)

Building the documentation articles

To build the QtWebKit documentation simply run make docs in your build directory, i.e. WebKitBuild/Release. The output will be generated in HTML in the doc/html subdirectory.

If you also need to work on the C++ API documentation that refers to the Qt API documentation, then you need to build Qt from sources. See for more information.


We can use the QtWebKit webkit-qt Mailing List and the #qtwebkit IRC channel on to discuss documentation, too.