You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openoffice.apache.org by ro...@apache.org on 2012/11/03 02:27:32 UTC

svn commit: r1405249 - in /incubator/ooo/site/trunk/content/openofficeorg/orientation: infrastructure.mdtext intro-contributing.mdtext

Author: robweir
Date: Sat Nov  3 01:27:31 2012
New Revision: 1405249

URL: http://svn.apache.org/viewvc?rev=1405249&view=rev
Log: (empty)

Modified:
    incubator/ooo/site/trunk/content/openofficeorg/orientation/infrastructure.mdtext
    incubator/ooo/site/trunk/content/openofficeorg/orientation/intro-contributing.mdtext

Modified: incubator/ooo/site/trunk/content/openofficeorg/orientation/infrastructure.mdtext
URL: http://svn.apache.org/viewvc/incubator/ooo/site/trunk/content/openofficeorg/orientation/infrastructure.mdtext?rev=1405249&r1=1405248&r2=1405249&view=diff
==============================================================================
--- incubator/ooo/site/trunk/content/openofficeorg/orientation/infrastructure.mdtext (original)
+++ incubator/ooo/site/trunk/content/openofficeorg/orientation/infrastructure.mdtext Sat Nov  3 01:27:31 2012
@@ -35,34 +35,53 @@ available to you by sending the *help* c
 who have additional capabilities.  You can find the moderators for our lists [here](http://incubator.apache.org/openofficeorg/pmc-faqs.html#mailing-lists).
 
 
+    * Our two websites: [www.openoffice.org](http://www.openoffice.org) and [openoffice.apache.org](http://openoffice.apache.org).  Why two?  There is some logic here,
+although it is not perfectly executed (yet).   The www.openoffice.org website is our primary user-facing website.  It is where we put content intended for end-users
+to use, so downloads, product documentations, support and other related materials.  The openoffice.apache.org website, on the other hand, is the main portal for
+project members, the contributors to the project.  We run the project on openoffice.apache.org, and the www.openoffice.org website is a service we provide to users.
+
     * MediaWiki (also called MWiki) is used for the wiki on the [wiki.openoffice.org](http://wiki.openoffice.org/wiki/Main_Page) website.
 We use MWiki for many of the user-facing pages on the website, especially in the areas of documentation and support.  If you are familiar with Wikipedia and 
 the syntax used for authoring articles there, then you will find our MediaWiki very easy to use, since Wikipedia
 also uses MediaWiki.  If you are new to MediaWiki please read over this [introduction to the basics](http://meta.wikimedia.org/wiki/Help:Editing).
 
-    * Confluence Wiki
+    * Confluence Wiki (also called CWiki) is used for some [project management webpages](https://cwiki.apache.org/confluence/display/OOOUSERS/Wiki+Home)
 
-    * Pootle is our translation management server, an online service used by translators to translate the UI 
-and help files of OpenOffice into various languages.  Unless you are involved with translations or builds you
-probably will never use Pootle.
+    * [Pootle](http://translate.apache.org) is our translation management server, an online service used by translators to translate the UI 
+and help files of OpenOffice into various languages.  Unless you are involved with translations or builds you probably will never use Pootle.  But you will hear
+it mentioned on the mailing lists.
 
-    * Apache CMS
+    * Apache CMS (Content Management System) is the software that manages our websites, including the application of side-wide templates used to apply, for example, 
+the common page footers that occur on each page).   There is a web interface to the Apache CMS that makes it easy to make small updates to a page.  If you are interested
+in adding or editing the website you can watch this video on the [Apache CMS's Anonymous Mode](http://www.youtube.com/watch?v=7fvg1pfHLhE) now.  Otherwise 
+this is a valuable skill you can pick up later.
 
-    * Subversion
+    * Subversion is the Version Control System (VCS) used by the project.  Subversion is also its own Apache project.  The source code for the OpenOffice product as well as 
+the files for the websites are all stored in Subversion.  Developers use Subversion heavily in their work.  Advanced work in QA and bulk website changes also involve using
+Subversion.
 
-    * phpBB is the software that runs our Community Forums, used for technical support of our users.
+    * phpBB is the software that runs our [Community Forums](http://forum.openoffice.org/en/forum/), used for technical support of our users.
 
-    * Bugzilla
+    * [Bugzilla](https://issues.apache.org/ooo/) is used to track defect OpenOffice (bug) report.
 
-    * JIRA
+    * [JIRA](https://issues.apache.org/jira/) is another issue tracking application.  Some Apache projects use JIRA instead of Bugzilla.  We mainly use JIRA when we 
+need to raise an issue with another group at Apache that uses JIRA, for example the Apache Infrastructure Team.
 
 1. The role of the Apache Infrastructure Team (Infra or Infra@)
 
+The [Infrastructure team](http://www.apache.org/dev/infrastructure.html) are essentially the system administrators for all Apache-wide servers and services, including 
+many of the services described above.  As you can imagine, with all the projects that are part of Apache, this is huge job.  In order to support this number of projects
+and provide good service levels in this shared infrastructure environment, we align ourselves with the common services that are made available to other projects.  
+In other words, we have a "menu" of services that we can enable for the project, and the ability to do some customization, within defined bounds, but we cannot easily use 
+a service outside of that menu.  
+
 1. What to do if you have a problem:
 
-    * Questions on how to use the service
-    * Outages
-    * Requests to enhance or modify the service
+    * Questions on how to use the service: First, look for intructions on the website.  If that fails, post a note to the ooo-dev mailing list for hints.
+    * Outages: [Current status](http://monitoring.apache.org/status/) is posted.  You might also want to subscribe to Infra's [Twitter feed](https://twitter.com/infrabot).
+    If you see an outage not noted there already, you can notify Infra via IRC channel #asfinfra on Freenode.
+    * Requests to enhance or modify the service: Propose something on ooo-dev.  Even though Infra is required to carry out some tasks, you still should get consensus 
+    first on the project's mailing list.
 
 1. Congratulations!  You have completed this Module.  Please send a note to [ooo-dev@incubator.apache.org](mailto:ooo-dev@incubator.apache.org?subject=Completed Infrastructure Module) so 
 we all know you have completed this level.   This is also a good opportunity to send along any feedback or questions you might have on this Orientation Module.

Modified: incubator/ooo/site/trunk/content/openofficeorg/orientation/intro-contributing.mdtext
URL: http://svn.apache.org/viewvc/incubator/ooo/site/trunk/content/openofficeorg/orientation/intro-contributing.mdtext?rev=1405249&r1=1405248&r2=1405249&view=diff
==============================================================================
--- incubator/ooo/site/trunk/content/openofficeorg/orientation/intro-contributing.mdtext (original)
+++ incubator/ooo/site/trunk/content/openofficeorg/orientation/intro-contributing.mdtext Sat Nov  3 01:27:31 2012
@@ -1,4 +1,4 @@
-Title:     Level 1: Introduction to Contributing to Apache OpenOffice
+Title:     Introduction to Contributing to Apache OpenOffice
 Notice:    Licensed to the Apache Software Foundation (ASF) under one
            or more contributor license agreements.  See the NOTICE file
            distributed with this work for additional information