[Spice-devel] RFC: Updating spice documentation for 0.6 release

[Arnon Gilboa]

Hi All,
The sources of the pdfs are at http://www.spice-space.org/page/Repositories
As I noted there, a major part of these docs are out-of-date and require 
some update work.
In addition, some of the content (especially the dynamic one) needs to 
be relocated to the wiki.
Regards,
Arnon

Hans de Goede wrote:
> Hi All,
>
> As Sigbjorn Lie pointed out in the
> "How can I move the mouse between spice client and local desktop 
> without Shift+F12?"
> Thread our documentation is currently a bit lacking / outdated.
>
> Sigbjorn has indicated that he is willing to help out with
> updating the documentation. Looking at for example:
> http://spice-space.org/docs/spice_user_manual.pdf
>
> Quite a bit of updating is needed. So this brings me to the following
> questions:
>
> 1) What and where is the source of the pdf's we currently have?
>
> 2) In which format do we want to have our documentation? Currently:
> -We have some docs on the wiki
> -We have some pdf's
> Some info is available in both, ie building from source instructions
> can be found in both:
> http://spice-space.org/docs/spice_user_manual.pdf
> http://spice-space.org/page/Building_Instructions
>
> With the second one being more or less up2date and the pdf containing
> instructions which are pretty much useless for the 0.6 series.
>
>
> All in all I think our documentation needs an overhaul, starting with
> defining a structure for the different documents and in which format(s)
> we want to make the various docs available.
>
> Note I'm not saying we should rewrite all the docs we currently have,
> but I think it would be a good idea to remove some things (like build
> instructions) from the pdf docs, and replace them with a pointer to the
> wiki, were they can be kept up2date much easier.
>
> I would very much appreciate input from others on this.
>
> Regards,
>
> Hans
> _______________________________________________
> Spice-devel mailing list
> Spice-devel at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/spice-devel