Improving Our Docs
Daniel van Vugt
daniel.van.vugt at canonical.com
Fri Jun 21 02:08:17 UTC 2013
Just some notes to consider before anyone tries to write docs:
* How to write a a Mir backend for a window manager / toolkit. This
could really help other projects that are interested in supporting Mir.
- Backend for a "window manager": This means a shell, linking to
libmirserver. I may be alone in thinking this, but am not comfortable we
have our class structure (via libmirserver) quite right to go
documenting this yet. But still, you can look at examples/demo-shell/*
which some might find surprising to hear is intended to be a totally
generic shell with no links to Unity. It still needs more functionality
- Toolkit: This means a client linking to libmirclient. The client API
is *almost* completely stable now. Changes are minimal these days so
it's safe to document, and the basics are documented:
* How to build Mir for non-Ubuntu systems. Jef Spaleta shared this
concern with me this week, and I think some more generic build
instructions would be useful.
- I totally agree we need to make building everything-Mir easier, for
everyone. We have had discussions and will work on easing the process. I
think it could be documented now but that documentation will of course
evolve with the projects themselves.
* How to write a driver that supports Mir. This could be of interest for
a hardware company who is interested in exploring Mir support for their
- This can not be documented until we have at least had a first
attempt at making it possible to load external code:
On 21/06/13 06:55, Jono Bacon wrote:
> Some time ago I asked Daniel Holbach to coordinate with the Mir team to
> improve the documentation on wiki.ubuntu.com/Mir
> <http://wiki.ubuntu.com/Mir> to make it simple to participate in Mir
> development. I think Daniel and the team did a great job there.
> There are now some other documentation needs that I think we need in
> light of recent discussions:
> * How to write a a Mir backend for a window manager / toolkit. This
> could really help other projects that are interested in supporting Mir.
> * How to build Mir for non-Ubuntu systems. Jef Spaleta shared this
> concern with me this week, and I think some more generic build
> instructions would be useful.
> * How to write a driver that supports Mir. This could be of interest
> for a hardware company who is interested in exploring Mir support for
> their hardware.
> I have Daniel to take care of working with our community and Mir
> engineers to put together these docs. Is anyone willing to help
> contribute to putting this content together as part of this effort?
> Jono Bacon
> Ubuntu Community Manager
> www.ubuntu.com <http://www.ubuntu.com> / www.jonobacon.org
> www.identi.ca/jonobacon <http://www.identi.ca/jonobacon>
> www.twitter.com/jonobacon <http://www.twitter.com/jonobacon>
More information about the Mir-devel