Bug 83431

Summary:	Integrate a better protocol document generator
Product:	Wayland	Reporter:	Pekka Paalanen <ppaalanen>
Component:	wayland	Assignee:	Wayland bug list <wayland-bugs>
Status:	RESOLVED FIXED	QA Contact:
Severity:	enhancement
Priority:	medium	CC:	jonny.lamb
Version:	unspecified
Hardware:	All
OS:	All
Whiteboard:
i915 platform:		i915 features:
Bug Depends on:
Bug Blocks:	83429

Description Pekka Paalanen 2014-09-03 10:23:24 UTC

We could generate the documentation from XML files better.

An example is here: http://people.collabora.com/~jonny/protocol/
It has been generated with: https://github.com/jonnylamb/wayland-docs

Especially the cross-references are an excellent feature.

If we are happy with a Python dependency, we should import the generator and integrate it to the big docs both build and content/style wise.

Comment 1 Daniel Stone 2018-06-04 08:17:49 UTC

We do at least have cross-references, though they aren't great. The website in general probably needs some help.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.