Login | Register For Free | Help
Search for: (Advanced)

Mailing List Archive: Xen: API

Do we still need Xen Document Days?

 

 

Xen api RSS feed   Index | Next | Previous | View Threaded


lars.kurth at xen

Aug 5, 2013, 4:12 AM

Post #1 of 2 (34 views)
Permalink
Do we still need Xen Document Days?

Hi,

Monday a week ago, we had a Xen Document Day. Due to the summer
holidays, OSCON and a couple of people who normally contribute being
ill, none of the regular contributors to document days were not around.
As a consequence we had no contributions. This was followed by a
discussion last week, I had with regular contributors to see what was
going on. In a nutshell the key points that were made are:

1) For Hypervisor Docs, there are no more "low hanging fruit" left over.
Even the regular contributors to document days, have difficulties
figureing out which documents actually need to be improved
2) This makes it increasingly difficulkt for newbies to participate in
document days
3) We have become better in creating documents for new features and for
new releases
4) In recent document days, discussions on the IRC channel were more
about making documents more accessible and easier to find, compared to

To counter balance this, we do have areas which have weak wiki
documentation. Notable areas are XAPI and Mirage: for these sub-projects
we never really got much community participation. Another question is
whether the fact that we had to lock down the wiki due to the recurring
spam attacks, is having a negative impact on wiki contributions and
document days in particular.

All these points, raise the question whether a) we still need to have
document days, and b) if we do, what we can do to increase
participation. I wanted to start a discussion about this, before I make
a proposal to kill document days, or maybe change them.

Input is desired. If there is no input, that will add to the case for
not having document days any more.

Best Regards
Lars

_______________________________________________
Xen-api mailing list
Xen-api [at] lists
http://lists.xen.org/cgi-bin/mailman/listinfo/xen-api


anil at recoil

Aug 5, 2013, 4:18 AM

Post #2 of 2 (33 views)
Permalink
Re: Do we still need Xen Document Days? [In reply to]

Regarding Mirage, we're prepping a release this week, which will finally stabilise the build instructions. After that's out, we can participate more easily in document days.

More docs on the internals of XAPI, particularly around disaggregation, would seem to be
most useful. Perhaps having a theme for each doc day to encourage subsystem maintainers
to show up would be useful?

-anil

On 5 Aug 2013, at 12:12, Lars Kurth <lars.kurth [at] xen> wrote:

> Hi,
>
> Monday a week ago, we had a Xen Document Day. Due to the summer holidays, OSCON and a couple of people who normally contribute being ill, none of the regular contributors to document days were not around. As a consequence we had no contributions. This was followed by a discussion last week, I had with regular contributors to see what was going on. In a nutshell the key points that were made are:
>
> 1) For Hypervisor Docs, there are no more "low hanging fruit" left over. Even the regular contributors to document days, have difficulties figureing out which documents actually need to be improved
> 2) This makes it increasingly difficulkt for newbies to participate in document days
> 3) We have become better in creating documents for new features and for new releases
> 4) In recent document days, discussions on the IRC channel were more about making documents more accessible and easier to find, compared to
>
> To counter balance this, we do have areas which have weak wiki documentation. Notable areas are XAPI and Mirage: for these sub-projects we never really got much community participation. Another question is whether the fact that we had to lock down the wiki due to the recurring spam attacks, is having a negative impact on wiki contributions and document days in particular.
>
> All these points, raise the question whether a) we still need to have document days, and b) if we do, what we can do to increase participation. I wanted to start a discussion about this, before I make a proposal to kill document days, or maybe change them.
>
> Input is desired. If there is no input, that will add to the case for not having document days any more.
>
> Best Regards
> Lars
>
> _______________________________________________
> Xen-api mailing list
> Xen-api [at] lists
> http://lists.xen.org/cgi-bin/mailman/listinfo/xen-api
>


_______________________________________________
Xen-api mailing list
Xen-api [at] lists
http://lists.xen.org/cgi-bin/mailman/listinfo/xen-api

Xen api RSS feed   Index | Next | Previous | View Threaded
 
 


Interested in having your list archived? Contact Gossamer Threads
 
  Web Applications & Managed Hosting Powered by Gossamer Threads Inc.