[RFC wayland-web] docs, web site, logo

Daniel Stone daniel at fooishbar.org
Sat Aug 20 10:54:29 UTC 2016

Hi Yong,

On 19 August 2016 at 20:08, Yong Bakos <junk at humanoriented.com> wrote:
> Hi everyone,
> This may feel a bit trivial but I would like to get a sense of how some
> improvements to the documentation, web site, and logo (!) might be received.
> Would you be strongly opposed to:
> 1) Migrating the docbook-like documentation into doxygen pages
>     Take a look at libinput[1] for an example.

Our biggest problem isn't the format of documentation we have, but the
volume of it. I'd rather leave this until someone actively working on
producing a bit of documentation said that they felt it hindered them
and the change would be good.

> 2) Publishing the doxygen docs on the web site

This is good and would be really useful. Even better if it's driven
out of CI so it's impossible for us to get it wrong.

> 3) A simple, but polished, redesign of the Wayland web site

I'd be in favour of this; we could definitely do a much better job at
communicating information to multiple audiences (end users who need to
be redirected; people who need guides on Wayland/Weston, their
requirements, and how to build; developers who need guides on its
structure, principles, and how to contribute, etc). And I think the
first thing to do would be to draw up our audience and what we need to
present to them.

> 4) Replacing the W logo with a high quality logo created by a designer

I think this is easily the lowest-priority issue here. It's not the
best, but it certainly works, and it's not really holding us back from
progress. It's also something that's relatively well recognised atm.


More information about the wayland-devel mailing list