Xen Project Document Days: Difference between revisions

From Xen
Jump to navigationJump to search
mNo edit summary
No edit summary
Line 6: Line 6:
{{Trailbox|Information about Document Days|TODO
{{Trailbox|Information about Document Days|TODO
|{{Trail|Next dates|
|{{Trail|Next dates|
* March 31, 2014
* April 30, 2014
* April 28, 2014
* May 28, 2014
* May 19, 2014
* June 25, 2014
* June 30, 2014
}}
}}
|{{Trail|More Information|
|{{Trail|More Information|
Line 24: Line 23:


== What is a Xen Project Document Day? ==
== What is a Xen Project Document Day? ==
Xen Project document days are all day IRC events, facilitated by members of the Xen community. The purpose of Xen Project Document Days is to
Xen Project document days are all day IRC events, facilitated by members of the Xen Project community. The purpose of Xen Project Document Days is to
* Improve user documentation
* Improve user documentation
* Improve developer documentation, including the creation of man pages, etc.
* Improve developer documentation, including the creation of man pages, etc.
Line 49: Line 48:
* More up-front coordination on the mailing list a week before the document day helps
* More up-front coordination on the mailing list a week before the document day helps


== Proposed dates for 2014 ==
== Initial proposed dates for 2014 ==
In 2013, we agreed on the mailing list that Xen Project Document days will be held the '''last Monday of each month'''. If the date clashes with say a major Xen event or a holiday, we will try and find an alternative date.
In 2013, we agreed on the mailing list that Xen Project Document days will be held the '''last Monday of each month'''. If the date clashes with say a major Xen Project event or a holiday, we will try and find an alternative date.


Following this rule, the 2014 dates are:
Following this rule, the initial 2014 dates were:
* January 27, 2014
* January 27, 2014
* February 24, 2014
* February 24, 2014
* March 31, 2014
* March 31, 2014

* April 28, 2014
In March 2014, it became clear that Mondays are problematic to many. Multiple countries have Monday holidays, a number of people's schedules are difficult on Mondays, etc. So, in April, we are starting to try on last Wednesdays.
* May 19, 2014 (set earlier due to US Memorial Day)
* June 30, 2014
* July 28, 2014
* August 25, 2014
* September 29, 2014
* October 27, 2014
* December 18, 2014 (between Christmas and US Thanksgiving)


== Extra Days ==
== Extra Days ==

Revision as of 00:39, 22 April 2014


Icon Ambox.png The Xen Project Wiki has been subject to a severe spam attack in the last several months. To solve this and keep the wiki usable for everyone, we had to lock down the wiki and create an editors group. Please fill out this form and we will add you to the group.

Information about Document Days
Next dates
  • April 30, 2014
  • May 28, 2014
  • June 25, 2014
More Information
IRC
  • Freenode channel #xendocs
  • Turn up
  • Work on documentation
  • Have fun!

What is a Xen Project Document Day?

Xen Project document days are all day IRC events, facilitated by members of the Xen Project community. The purpose of Xen Project Document Days is to

  • Improve user documentation
  • Improve developer documentation, including the creation of man pages, etc.
  • Improve and maintaining the wiki: this means fixing important pages, retiring old ones, help identify what is and isn’t important, write new pages, etc.

How Does it Work?

  • Join us on IRC: freenode channel #xendocs
  • Tell people what you intend to work on (to avoid doing something somebody else is already working on)
  • Fix some documentation
  • Help others
  • And above all: have fun!

Other ways to Help

Let us know if you struggled with some content, if something is missing, can be improved and you do not feel sure enough to make changes to a page. The way to do this is by making a comment on talk pages. Every wiki page has an associated talk page which can be used for discussion and communicating with other users. Talk pages can be accessed by clicking the “discussion” tab at the top of the page. Simply edit the page as normal to add your comment, following the conventions outlined in Help:Talk Pages.

Stats

  • Xen_Document_Days/Acknowledgements/Jan2013: We changed >11K words on the wiki in more than 126 changesets. Changes to xen.org static pages were made. More than 25 people participated on IRC, and we had vibrant discussions on how to change navigation and other items, which led to new sections in the TODO list, e.g. Mediwiki Issues and XCP : Open work items
  • July 2012: We changed approximately 5K words in more than 100 changesets on the wiki and much more in xen-unstable (see here)
  • June 2012: Thank you for all the contributions. On the Xen wiki we changed approximately 11K words in more than 200 changesets. More details here.

Lessons learned:

  • More up-front coordination on the mailing list a week before the document day helps

Initial proposed dates for 2014

In 2013, we agreed on the mailing list that Xen Project Document days will be held the last Monday of each month. If the date clashes with say a major Xen Project event or a holiday, we will try and find an alternative date.

Following this rule, the initial 2014 dates were:

  • January 27, 2014
  • February 24, 2014
  • March 31, 2014

In March 2014, it became clear that Mondays are problematic to many. Multiple countries have Monday holidays, a number of people's schedules are difficult on Mondays, etc. So, in April, we are starting to try on last Wednesdays.

Extra Days

Some community members indicated that they would like an extra doc day on a public holiday or weekend. We are looking for proposed dates. Please add dates below and sign up besides it. If we get more than 5 people signed up, we should hold a day on a weekend.