Interim doc push

Starting major update of documentation technical content, but need
to rework tree structure.  Therefore, pushing up existing changes.
They are not intented to be complete nor accurate yet.  More to come.

Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
master
Jeff Scheel 9 years ago
parent bd86323a76
commit 3da73be554

@ -9,7 +9,7 @@
<!-- TODO: When ready to publish document, remove the 'status="draft"' statement from the book object above. --> <!-- TODO: When ready to publish document, remove the 'status="draft"' statement from the book object above. -->


<!-- TODO: Pick a Title for the new document --> <!-- TODO: Pick a Title for the new document -->
<title>Template Guide</title> <title>Master Template Guide</title>
<!-- TODO: Either add a subtitle or remove the following line --> <!-- TODO: Either add a subtitle or remove the following line -->
<subtitle>A quick start template</subtitle> <subtitle>A quick start template</subtitle>


@ -17,14 +17,14 @@
<author> <author>
<personname> <personname>
<!-- TODO: Insert appropriate firstname and surnames --> <!-- TODO: Insert appropriate firstname and surnames -->
<firstname>Firstname</firstname> <firstname>Jeff</firstname>
<surname>Lastname</surname> <surname>Scheel</surname>
</personname> </personname>
<!-- TODO: Set correct email address of document author --> <!-- TODO: Set correct email address of document author -->
<email>Email@domain</email> <email>scheel@us.ibm.com</email>
<affiliation> <affiliation>
<!-- TODO: Insert appropriate orgname --> <!-- TODO: Insert appropriate orgname -->
<orgname>Company</orgname> <orgname>IBM</orgname>
</affiliation> </affiliation>
</author> </author>
<copyright> <copyright>
@ -33,7 +33,7 @@
<holder>OpenPOWER Foundation</holder> <holder>OpenPOWER Foundation</holder>
</copyright> </copyright>
<!-- TODO: Set the correct document releaseinfo --> <!-- TODO: Set the correct document releaseinfo -->
<releaseinfo>Revision 0.9</releaseinfo> <releaseinfo>Revision 0.9.1</releaseinfo>
<productname>OpenPOWER</productname> <productname>OpenPOWER</productname>
<pubdate/> <pubdate/>


@ -57,8 +57,28 @@
--> -->


<revhistory> <revhistory>
<!-- TODO: Set the initial version information and clear any old information out -->
<revision>
<date>2016-01-25</date>
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para>Version 0.9.1: Technical and process updates.</para>
</listitem>
</itemizedlist>
</revdescription>
</revision>
<revision>
<date>2015-08-20</date>
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para>Version 0.9: Draft for format review with TSC.</para>
</listitem>
</itemizedlist>
</revdescription>
</revision>
<revision> <revision>
<!-- TODO: Set the initial version information -->
<date>2014-09-03</date> <date>2014-09-03</date>
<revdescription> <revdescription>
<itemizedlist spacing="compact"> <itemizedlist spacing="compact">

@ -22,14 +22,14 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_getting_star
source and maven provides the build framework to create the published content in PDF and html form. 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.</para> Installation steps for these tools varies by operating system.</para>
<para>On Debian-based Linux operating systems (Ubuntu and Debian), install maven and git as follows: <para>On Debian-based Linux operating systems (Ubuntu and Debian), install maven and git as follows:
<screen><prompt>$</prompt><userinput>sudo apt-get install git</userinput> <screen><prompt>#</prompt><userinput>apt-get install git</userinput>
<prompt>$</prompt><userinput>sudo apt-get install maven</userinput></screen></para> <prompt>#</prompt><userinput>apt-get install maven</userinput></screen></para>
<para>On RPM-based Linux operating systems (Fedora, RHEL, openSUSE, SLES), install maven and git as follows: <para>On RPM-based Linux operating systems (Fedora, RHEL, openSUSE, SLES), install maven and git as follows:
<screen><prompt>$</prompt><userinput>sudo yum install git</userinput> <screen><prompt>#</prompt><userinput>yum install git</userinput>
<prompt>$</prompt><userinput>sudo yum install maven</userinput></screen></para> <prompt>#</prompt><userinput>yum install maven</userinput></screen></para>
<para>On Mac OS X, use Macports to install maven and git as follows: <para>On Mac OS X, use Macports to install maven and git as follows:
<screen><prompt>$</prompt><userinput>sudo port install git</userinput> <screen><prompt>#</prompt><userinput>port install git</userinput>
<prompt>$</prompt><userinput>sudo port install maven3</userinput></screen></para> <prompt>#</prompt><userinput>port install maven3</userinput></screen></para>
<para>or use Homebrew to install maven and git as follows: <para>or use Homebrew to install maven and git as follows:
<screen><prompt>$</prompt><userinput>brew install git</userinput> <screen><prompt>$</prompt><userinput>brew install git</userinput>
<prompt>$</prompt><userinput>brew install maven</userinput></screen></para> <prompt>$</prompt><userinput>brew install maven</userinput></screen></para>
@ -48,9 +48,13 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_getting_star


<section> <section>
<title>Creating accounts</title> <title>Creating accounts</title>
<para>All OpenPOWER project documentation is maintained in GitHub trees, public and private. To join the GitHub community, <para>All OpenPOWER project documentation is maintained in GitHub trees, public and private. The first
step to creating documentation will be joining the GitHub community.</para>
<para>To join the GitHub community,
apply at <link xlink:href="https://github.com/join">https://github.com/join</link>.</para> apply at <link xlink:href="https://github.com/join">https://github.com/join</link>.</para>
<para>If you will be participating in private OpenPOWER Foundation trees, you will need to visit the OpenPOWER Foundation Members <para>The private trees are grouped in the OpenPOWER Foundation project at
<link xlink:href="https://github.com/OpenPOWERFoundation">https://github.com/OpenPOWERFoundation</link>.
If you will be participating in private OpenPOWER Foundation trees, you will need to visit the OpenPOWER Foundation Members
Area wiki to find administrators for the appropriate git tree.</para> Area wiki to find administrators for the appropriate git tree.</para>
<para>To learn more about using git, see the online article in GitHub Help, "Good Resources for Learning Git and GitHub." at <para>To learn more about using git, see the online article in GitHub Help, "Good Resources for Learning Git and GitHub." at
<link xlink:href="https://help.github.com/articles/good-resources-for-learning-git-and-github/"> <link xlink:href="https://help.github.com/articles/good-resources-for-learning-git-and-github/">

@ -48,6 +48,11 @@ Checking connectivity... done.
<screen><prompt>$</prompt><userinput>mkdir my_proj</userinput> <screen><prompt>$</prompt><userinput>mkdir my_proj</userinput>
<prompt>$</prompt><userinput>cp -r template/* my_proj</userinput> <prompt>$</prompt><userinput>cp -r template/* my_proj</userinput>
<prompt>$</prompt></screen></para> <prompt>$</prompt></screen></para>
</listitem>
<listitem>
<para>Add the new project to the master POM.xml file. Using your editor, add the following lines
between the &lt;modules> and the &lt;/modules> tags near the top of the file:<programlisting><![CDATA[<module>my_proj</module>
]]></programlisting></para>
</listitem> </listitem>
<listitem> <listitem>
<para>Finally, make sure to add the new directory to the git repository. <para>Finally, make sure to add the new directory to the git repository.

@ -25,6 +25,11 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_policies">
</listitem> </listitem>
</orderedlist> </orderedlist>
</para> </para>
<para>In addition to documentation documentation structure, general community/project guidelines are as follows
<orderedlist>
<listitem><para></para></listitem>
</orderedlist>
</para>


</section> </section>

Loading…
Cancel
Save