Getting startedTo begin contributing to the OpenPOWER Foundation documentation, the following steps must be completed:
Once complete, you can proceed to either or
as needed.Installing toolsOnly two tools are required to update documentation, git and maven. Git manages the documentation
source and maven provides the build framework to create the published content in PDF and html form.
Installation steps for these tools varies by operating system.On Debian-based Linux operating systems (Ubuntu and Debian), install maven and git as follows:
# apt-get install git# apt-get install mavenOn RPM-based Linux operating systems (Fedora, RHEL, openSUSE, SLES), install maven and git as follows:
# yum install git# yum install mavenOn Mac OS X, use Macports to install maven and git as follows:
# port install git# port install maven3or use Homebrew to install maven and git as follows:
$ brew install git$ brew install mavenFor information on how to setup the environment on Windows, see the following websites:
git for Windows - http://msysgit.github.io/Maven on Windows -
http://maven.apache.org/guides/getting-started/windows-prerequisites.htmlModification of documentation source files requires a text editor. While standard editors like vim, emacs, or gedit can be used,
it is highly recommended that an editor be used which highlights XML or Docbook syntax. If your favorite editor does not include an
extension or plugin to accomplish this, you might consider using Bluefish to edit your docbook files. Details on this editor
can be found at http://bluefish.openoffice.nl/index.html.Installing fontsThe OpenPOWER Foundation documentation utilizes opensource fonts known as the
Chrome OS core fonts or Croscore fonts.
The three TrueType fonts (TTFs) in this family Arimo (sans-serif), Tinos (serif), and Cousine (monospace). While
not strictly required to have these fonts on your system, it can be helpful when designing graphics and
other images to have them installed on your development system.Only two tools are required to update documentation, git and maven. Git manages the documentation
source and maven provides the build framework to create the published content in PDF and html form.
Installation steps for these tools varies by operating system.On Debian-based Linux operating systems (Ubuntu and Debian), install Croscore fonts as follows:
# apt-get install fonts-croscoreOn RPM-based Linux operating systems (Fedora, RHEL, openSUSE, SLES), install Croscore fonts as follows:
# yum install google-croscore-fontsOn Mac OS X and Windows systems, use a font website to download and install the Croscore fonts individually. Most of
these sites provide directions for Mac OS and Windows.Creating accountsAll OpenPOWER project documentation is maintained in GitHub trees, public and private. The first
step to creating documentation will be joining the GitHub community.To join the GitHub community,
apply at https://github.com/join.The OpenPOWER Foundation documentation trees are grouped in the OpenPOWER Foundation project at
https://github.com/OpenPOWERFoundation.
Everyone should be able to see and access public trees like Docs-Master. However,
if you will be participating in private OpenPOWER Foundation trees, you will need to request access from the
Technical Steering Committee Chair, tsc-chair@openpowerfoundation.org.To learn more about using git, see the online article in GitHub Help, "Good Resources for Learning Git and GitHub." at
https://help.github.com/articles/good-resources-for-learning-git-and-github/.Cloning master document informationTo successfully build OpenPOWER Foundation documents, common document files must be in place in addition to the specific
document files. These common files are obtained by cloning the OpenPOWER Foundation public project Docs-Master.To clone the OpenPOWER Foundation master document framework,
use the clone git command:$ git clone https://github.com/OpenPOWERFoundation/Docs-Master.git
Cloning into 'Docs-Master'...
remote: Counting objects: 24, done.
remote: Compressing objects: 100% (18/18), done.
remote: Total 24 (delta 6), reused 20 (delta 5), pack-reused 0
Unpacking objects: 100% (24/24), done.
Checking connectivity... done.
$ More information can be found about the Docs-Master project online at
https://github.com/OpenPOWERFoundation/Docs-Master. Additional details about the OpenPOWER Foundation documentation structure
are explained in of this document.