Difference between revisions of "Qt-contributors-summit-2013-Documentation-Content-and-Structure"

From Qt Wiki
Jump to: navigation, search
(Simplify punctuation)
m (Categorize)
Line 1: Line 1:
{{Cleanup | reason=Auto-imported from ExpressionEngine.}}
{{Cleanup | reason=Auto-imported from ExpressionEngine.}}
Proposed topics:
Proposed topics:

Latest revision as of 17:18, 6 January 2017

Proposed topics: -General introduction and "how documentation works"
-Publishing new projects and setting up new module documentation
-Content and usability Some ideas, wishes, and proposals in the session: -Keep DITAXML output because Blackberry documentation needs it
-Keep QDoc because of the QML support and the amount of documentation to convert to be done
-Host .qch files at the doc-snapshot.qt.io site (or elsewhere) for people to download
-Readability and information flow needs to be consistent – Maybe combine pages into one long page? – Edit the use of the landing pages and API pages and the use of the visible text. (Clicking a link may take you elsewhere) – Maybe have the commit template or CI warn about the use of the links – Jerome: the usage of links is hard to enforce but it is possible to catch them during the review time – The use of module name is not clear to developers or authors. "Qt QML" and "QtQml" go to different pages.
-Can we get the doc sanity bot to check the other repositories? – We can host the QDoc warnings online too
-Keep the important information in the reference, not wikis or forums.
-Redirects in qt.io and qt.digia.com needs auditing.