First draft of Smartdocs - FreeRADIUS Server Setp

articles/freeradius-setup-server.asm.xml

@@ -38,18 +38,19 @@
   </resources>-->
   <!-- Tasks -->
   <resources>
-    <resource href="../tasks/freeradius-setting-up-server.xml" xml:id="_freeradius-setting-up-server" >
-      <description>FreeRADIUS Set up server task.</description>
-    </resource>
-    <resource href="../concepts/freeradius-concept.xml" xml:id="_freeradius-concept">
+   <resource href="../concepts/freeradius-concept.xml" xml:id="_freeradius-concept">
       <description>FreeRADIUS server concept</description>
     </resource>
     <resource href="../tasks/freeradius-installing-server.xml" xml:id="_freeradius-installing-server">
       <description>Installing FreeRADIUS server</description>
     </resource>
-    <resource href="../tasks/freeradius-start-freeradius.xml" xml:id="_freeradius-start-freeradius">
-    </resource>
-      </resources>
+    <resource href="../tasks/freeradius-start-server.xml" xml:id="_freeradius-start-server"></resource>
+    <resource href="../tasks/freeradius-create-test-certificates.xml" xml:id="_freeradius-create-test-certificates"></resource>
+    <resource href="../tasks/freeradius-add-client-user.xml" xml:id="_freeradius-add-client-user"></resource>
+    <resource href="../tasks/freeradius-start-freeradius.xml" xml:id="_freeradius-start-freeradius"></resource>
+    <resource href="../tasks/freeradius-test-authentication.xml" xml:id="_freeradius-test-authentication">
+  </resource>
+  </resources>
   <!-- References -->
   <!--<resources>
     <resource xml:id="_reference-example" href="../references/reference.xml">
@@ -66,7 +67,7 @@
     </resource>
   </resources>
   <!-- S T R U C T U R E -->
-  <structure renderas="article" xml:id="FreeRADIUS-server" xml:lang="en">
+  <structure renderas="article" xml:id="freeradius-server" xml:lang="en">
     <merge>
       <title>Setting Up FreeRADIUS server</title>
      <!-- <subtitle>Subtitle if necessary</subtitle>-->
@@ -171,7 +172,7 @@
           <term>REQUIREMENTS</term>
            <listitem><itemizedlist><listitem><para>A separate machine from your Network Attached Storage (NAS) to install FreeRADIUS.</para></listitem> <listitem><para>The <systemitem class="resource">freeradius-server</systemitem> and
               <systemitem class="resource">freeradius-server-utils</systemitem>
-              packages installed on this machine.</para></listitem> <listitem><para>Install <systemitem class='resource'>freeradius-server-utils</systemitem> on a another machine on your network, for testing client functions.</para></listitem></itemizedlist>
+              packages installed on this machine.</para></listitem> <listitem><para>Install <systemitem class='resource'>freeradius-server-utils</systemitem> on another machine on your network to test client functions.</para></listitem></itemizedlist>
             </listitem>           
         </varlistentry>
       </variablelist>
@@ -191,7 +192,13 @@
    <!-- <module resourceref="_reference-example" renderas="section"/>
     <module resourceref="_glue-more-info" renderas="section"/>
     <module resourceref="_glue-whats-next" renderas="section"/>-->
-    <module resourceref="_freeradius-start-freeradius" renderas="section"/>
+    <module resourceref="_freeradius-concept" renderas="section"></module>
+    <module resourceref="_freeradius-installing-server" renderas="section"></module>
+    <module resourceref="_freeradius-create-test-certificates" renderas="section"></module>
+    <module resourceref="_freeradius-start-server" renderas="section"/>
+    <module resourceref="_freeradius-add-client-user" renderas="section"></module>
+    <module resourceref="_freeradius-start-freeradius" renderas="section"></module>
+    <module resourceref="_freeradius-test-authentication" renderas="section"></module>
     <module resourceref="_legal" renderas="section"/>
     <module resourceref="_gfdl" renderas="appendix"/>
     </structure>

tasks/freeradius-add-client-user.xml

@@ -8,7 +8,7 @@
 <!-- point back to this document with a similar comment added to your legacy doc piece -->
 <!-- refer to README.md for file and id naming conventions -->
 <!-- metadata is dealt with on the assembly level -->
-<topic xml:id="freeradius-setting-up-server"
+<topic xml:id="freeradius-add-client-user"
  role="task" xml:lang="en"
  xmlns="http://docbook.org/ns/docbook" version="5.2"
  xmlns:its="http://www.w3.org/2005/11/its"

tasks/freeradius-create-test-certificates.xml

@@ -8,7 +8,7 @@
 <!-- point back to this document with a similar comment added to your legacy doc piece -->
 <!-- refer to README.md for file and id naming conventions -->
 <!-- metadata is dealt with on the assembly level -->
-<topic xml:id="freeradius-setting-up-server"
+<topic xml:id="freeradius-create-test-certificates"
  role="task" xml:lang="en"
  xmlns="http://docbook.org/ns/docbook" version="5.2"
  xmlns:its="http://www.w3.org/2005/11/its"
@@ -26,7 +26,7 @@ in the assembly -->
       </para>
     </abstract>
   </info>
- <section xml:id="introduction-setup-free-radius-server">
+ <section xml:id="create-test-certificates">
   <title>Create test certificates</title><procedure>
   <step>
     <para>Create a set of test certificates in <filename>/etc/raddb/certs</filename>.</para>

tasks/freeradius-installing-server.xml

@@ -8,7 +8,7 @@
 <!-- point back to this document with a similar comment added to your legacy doc piece -->
 <!-- refer to README.md for file and id naming conventions -->
 <!-- metadata is dealt with on the assembly level -->
-<topic xml:id="freeradius-setting-up-server"
+<topic xml:id="freeradius-installing-server"
  role="task" xml:lang="en"
  xmlns="http://docbook.org/ns/docbook" version="5.2"
  xmlns:its="http://www.w3.org/2005/11/its"

tasks/freeradius-setting-up-server.xml

@@ -26,7 +26,7 @@ in the assembly -->
       </para>
     </abstract>
   </info>
- <section xml:id="introduction-setup-free-radius-server">
+ <section xml:id="setup-freeradius-server">
   <title>Introduction</title>
    <para>
      The RADIUS (Remote Authentication Dial-In User Service) protocol has

tasks/freeradius-start-freeradius.xml

@@ -8,7 +8,7 @@
 <!-- point back to this document with a similar comment added to your legacy doc piece -->
 <!-- refer to README.md for file and id naming conventions -->
 <!-- metadata is dealt with on the assembly level -->
-<topic xml:id="freeradius-setting-up-server"
+<topic xml:id="freeradius-start-freeradius"
  role="task" xml:lang="en"
  xmlns="http://docbook.org/ns/docbook" version="5.2"
  xmlns:its="http://www.w3.org/2005/11/its"

tasks/freeradius-start-server.xml

@@ -8,7 +8,7 @@
 <!-- point back to this document with a similar comment added to your legacy doc piece -->
 <!-- refer to README.md for file and id naming conventions -->
 <!-- metadata is dealt with on the assembly level -->
-<topic xml:id="freeradius-setting-up-server"
+<topic xml:id="freeradius-start-server"
  role="task" xml:lang="en"
  xmlns="http://docbook.org/ns/docbook" version="5.2"
  xmlns:its="http://www.w3.org/2005/11/its"

tasks/freeradius-test-authentication.xml

@@ -8,7 +8,7 @@
 <!-- point back to this document with a similar comment added to your legacy doc piece -->
 <!-- refer to README.md for file and id naming conventions -->
 <!-- metadata is dealt with on the assembly level -->
-<topic xml:id="freeradius-setting-up-server"
+<topic xml:id="freeradius-test-authentication"
  role="task" xml:lang="en"
  xmlns="http://docbook.org/ns/docbook" version="5.2"
  xmlns:its="http://www.w3.org/2005/11/its"