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-...@incubator.apache.org](mailto:ooo-...@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


Reply via email to