using java

en-US/modules/ass_java.adoc

@@ -0,0 +1,23 @@
+[id='java']
+= Using Java
+
+Java provides a platform for creating and running applications. You can install various versions of Java to suit your requirements.
+
+include::con_java.adoc[leveloffset=+1]
+include::proc_installing_openjdk.adoc[leveloffset=+1]
+include::proc_installing_oracle_java.adoc[leveloffset=+1]
+
+
+
+.Additional resources
+
+For more information about Java, see:
+
+* link:https://en.wikipedia.org/wiki/Java_(programming_language)[Wikipedia page for Java]
+* link:http://openjdk.java.net/[OpenJDK homepage]
+* link:http://oracle.com/java/[Oracle homepage for Java]
+If you want to develop Java applications, you might consider the following open source IDEs:
+
+* link:https://netbeans.org/[NetBeans]
+* link:https://eclipse.org/[Eclipse]
+* link:https://www.jetbrains.com/idea/[IntelliJ IDEA]

en-US/modules/con_java.adoc

@@ -0,0 +1,12 @@
+[id='about-java']
+= About Java
+
+Java is a popular programming language that allows you run programs on many platforms, including Fedora. 
+If you want to create Java programs, you need to install a JDK (Java Development Kit). If you want to run a Java program, you can do that on a JVM (Java Virtual Machine), which is provided with the JRE (Java Runtime Environment).
+If in doubt, install the JDK because this is sometimes required even if the intention is not to write Java programs. 
+
+Many flavors of Java exist, and also many versions of each flavor. If you want to just run a specific application, check the documentation of that software to see what versions of Java are supported or have been tested. Most Java applications run on one of the following:
+
+* OpenJDK - an open-source implementation of the Java Platform, Standard Edition
+* Oracle Java SE - a free JDK from Oracle
+

en-US/modules/proc_installing_openjdk.adoc

@@ -0,0 +1,36 @@
+[id='installing-openjdk']
+= Installing  OpenJDK
+
+To install OpenJDK from the Fedora repository:
+
+. Run the following command to list available versions:
++
+----
+$ dnf search openjdk
+----
+. Copy the version of OpenJDK you want to install.
++
+[NOTE]
+====
+Various flavors of OpenJDK are available. For information about these options, search the link:http://openjdk.java.net/[OpenJDK web site].
+====
+. Run the following command to install OpenJDK:
++
+----
+$ dnf install <openjdk-package-name>
+----
++
+For example:
++
+----
+$ dnf install java-1.8.0-openjdk.x86_64
+----
+[NOTE]
+====
+If you have installed other versions of Java, you might need to switch the active version of java:
+----
+sudo alternatives --config java
+----
+A list of installed java versions is displayed. Choose the version you require.
+====
+

en-US/modules/proc_installing_oracle_java.adoc

@@ -0,0 +1,22 @@
+[id='installing-oracle-java']
+= Installing Oracle Java SE
+
+To install Oracle Java SE:
+
+. Navigate to link:http://www.oracle.com/technetwork/java/javase/downloads[Oracle Java SE downloads page].
+. Choose the version of Java you wish to use. Typically, you would navigate to the link:http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
+[version 8 page].
+. Accept the license agreement and download the appropriate rpm file for your systems architecture. For example, if you run 64 bit Fedora, choose the `jdk-8u151-linux-x64.rpm` file.
+. Enter the following command to install Oracle Java SE: 
++
+----
+$ rpm -i jdk-8u151-linux-x64.rpm
+----
+[NOTE]
+====
+If you have installed other versions of Java, you might need to switch the active version of java:
+----
+sudo alternatives --config java
+----
+A list of installed java versions is displayed. Choose the version you require.
+====