Diff for /doc/help/developer.manual.texxml between versions 1.4 and 1.5

version 1.4, 2003/07/25 04:14:32 version 1.5, 2003/09/22 19:08:39
Line 2 Line 2
  <title name="LON-CAPA Developer's Manual" />   <title name="LON-CAPA Developer's Manual" />
  <file name="Developer_Manual_Title_Page.tex"/>   <file name="Developer_Manual_Title_Page.tex"/>
   
  <section name="LON-CAPA High-Level Overview">   <section name="About This Document">
  <subsection name="LON-CAPA Network">   <file name="About_Developers_Manual.tex" />
    </section>
   
    <section name="What is LON-CAPA?">
    <file name="What_Is_LON-CAPA.tex" />
    <subsection name="Why LON-CAPA?">
    <file name="Why_LON-CAPA.tex" />
    </subsection>
    <subsection name="Features">
    <tex content="TBD" />
    </subsection>
    <subsection name="Philosophy and Pedagogy">
    <tex content="TBD" />
    </subsection>
    <subsection name="Conclusion">
    <tex content="We hope by now you're as excited as we are about the system. LON-CAPA
   is really powerful and good for both students and instructors, and
   you can't beat the bang-for-the-buck.
   
   Now you know what LON-CAPA is all about, let's start looking at the
   internals to see how we do all this great stuff." />
    </subsection>
    </section>
   
    <section name="Resources Overview">
    <tex content="In a nutshell, LON-CAPA is all about bringing learning \textbf{resources} and \textbf{people} together with \textbf{technology}. Thus, the best way to understand the system is to understand how it models learning resources, how it understand people, and last (and really, least importantly) what technology supports it." />
    <file name="Guts_Authoring.tex" />
   te <subsection name="LON-CAPA Network">
  <pod file="lonc" section="OVERVIEW/.+" h1level='2' />   <pod file="lonc" section="OVERVIEW/.+" h1level='2' />
  </subsection>   </subsection>
    <subsection name="Courses">
    <tex content="The end result of all of this assembly is an actual course that students can participate in." />
    <tex content="Courses are themselves sequences that tell the system what the course consists of. Course instructors or administrators can manipulate this sequence through the use of the Course Documents screen; see the Course Documents Screen chapter in the Course Management Manual (http://msu.loncapa.org/adm/help/course.manual.pdf) for more detailed information about that." />
    <pod file="../rat/lonuserstate.pm" section="OVERVIEW/.+" h1level='2' />
    <subsubsection name="Sections">
    <tex content='LON-CAPA fully supports the idea of "sections" in a course. Roles can be assigned to specific sections, allowing you to create Teaching Assisstants or Instructors that have power only over students in their section, and directly recieve student feedback from their corresponding students. As discussed in the next section, assignments parameters such as due dates can be set by section, which is extremely helpful in very large courses with tens of sections.' />
    </subsubsection>
    </subsection>
    <subsection name="Cascading Parameters">
    <file name="Cascading_Parameters.tex" />
    <subsubsection name="Parameters As Seen By Users">
    <tex content="\textit{The following is from the Course Administrator's Manual, describing how the cascading parameters are seen from the LON-CAPA user's point of view.}" />
    <file name="Course_Parameter_Levels.tex" />
    </subsubsection>
    </subsection>
    <subsection name="Finding Resources">
    <file name="Finding_Resources.tex" />
    <tex content="Note: more details belong here" />
    <subsection name="Permissions">
    <tex content="TBD" />
    </subsection>
    <subsection name="Navigation">
    <tex content="TBD" />
    </subsection>
    </section>
   
    <section name="People Overview">
    <tex content="LON-CAPA is a roles-based system. A single physical person will typically have one login, which will granted various roles connected to various courses or domains." />
    <subsection name="Authentication">
    <tex name="Authentication.tex" />
    </subsection>
    <subsection name="Roles">
    <tex name="Roles_About.tex" />
    </subsection>
    <subsection name="Communication">
    <subsubsection name="Internal Email">
    <pod file="interface/lonmsg.pm" section="OVERVIEW/Messaging Overview" />
    <tex content="When a resource fails to work for some reason, usually because of a programming error in a problem, the instructor will recieve a "bomb" message as an internal email, showing them exactly what went wrong, and for whom it went wrong, allowing them to take appropriate corrective action. This "bomb" message will show up in their email, and also as a bomb icon on the instructor's Navigation screen." />
    </subsubsection>
    <subsubsection name="Resource Discussion">
    <tex file="Resource_Discussion.tex" />
    </subsubsection>
    <subsubsection name="Chat">
    <tex file="Chatting.tex" />
    </subsubsection>
    <subsubsection name="About Communication">
    <tex file="About_Communication.tex" />
    </subsubsection>
    </subsection>
    </section>
   
    <section name="Technology Overview">
  <subsection name="Data Storage">   <subsection name="Data Storage">
  <subsubsection name="User Data Storage">   <subsubsection name="User Data Storage">
  <file name="Guts_User_Dir.tex" />   <file name="Guts_User_Dir.tex" />
Line 20 Line 99
  <pod file="auth/lonroles.pm" section="OVERVIEW/Choosing Roles" />   <pod file="auth/lonroles.pm" section="OVERVIEW/Choosing Roles" />
  <pod file="auth/lonroles.pm" section="OVERVIEW/Role Initialization" />   <pod file="auth/lonroles.pm" section="OVERVIEW/Role Initialization" />
  </subsection>   </subsection>
  <subsection name="Messaging">  
  <pod file="interface/lonmsg.pm" section="OVERVIEW/Messaging Overview" />  
   
  </subsection>  
  <subsection name="Resources and Publication">   <subsection name="Resources and Publication">
  <pod file="publisher/lonpublisher.pm section="OVERVIEW" />   <pod file="publisher/lonpublisher.pm" section="OVERVIEW" />
  <pod file="../rat/lonratedt.pm" section="OVERVIEW" />   <pod file="../rat/lonratedt.pm" section="OVERVIEW" />
  <file name="Guts_Authoring.tex" />   <file name="Guts_Authoring.tex" />
  <pod file="../rat/lonuserstate.pm" section="OVERVIEW" />   </subsection>
    <subsection name="Coding Guidelines">
    <file name="Guts_Coding_Guidelines.tex" />
    </subsection>
  </section>   </section>
   
  <section name="About The Webserver Environment">   <section name="Technology Overview - Webserver">
  <subsection name="Apache">   <subsection name="Apache">
  <file name="Guts_Apache.tex" />   <file name="Guts_Apache.tex" />
  </subsection>   </subsection>
Line 46 Line 124
  </subsection>   </subsection>
  </section>   </section>
   
    <file name="Developer_Tutorial.tex" />
   
    <section name="Internationalizing LON-CAPA">
    <pod file="localize/lonlocal.pm" section="!NAME|SYNOPSIS" />
    </section>
   
  <section name="Navigation Maps Rendering and Info">   <section name="Navigation Maps Rendering and Info">
  <pod file="interface/lonnavmaps.pm" section="!NAME|SYNOPSIS" />   <pod file="interface/lonnavmaps.pm" section="!NAME|SYNOPSIS" />
  </section>   </section>
Line 55 Line 139
  section="!NAME|SYNOPSIS" />   section="!NAME|SYNOPSIS" />
  </section>   </section>
   
    <section name="Helpers">
    <pod file="interface/lonhelper.pm"
    section="!NAME|SYNOPSIS" />
    </section>
   
  <section name="Construction Space And Publishing">   <section name="Construction Space And Publishing">
  <subsection name="Handling Uploaded Files">   <subsection name="Handling Uploaded Files">
  <pod file="publisher/lonupload.pm" section="!NAME|SYNOPSIS" h1level='3' />   <pod file="publisher/lonupload.pm" section="!NAME|SYNOPSIS" h1level='3' />
Line 88 Line 177
  <subsection name="lond">   <subsection name="lond">
  <pod file="lond" section="!NAME|SYNOPSIS|OVERVIEW" h1level='3' />   <pod file="lond" section="!NAME|SYNOPSIS|OVERVIEW" h1level='3' />
  </subsection>   </subsection>
    <subsection name="lonsql">
    <pod file="lonsql" section="!NAME|SYNOPSIS" h1level='3' />
    </subsection>
  </section>   </section>
   
  <section name="Common HTML routines">   <section name="Common HTML routines: Apache::loncommon">
  <pod file="interface/loncommon.pm" section="!NAME|SYNOPSIS" />   <pod file="interface/loncommon.pm" section="!NAME|SYNOPSIS" />
  </section>   </section>
   
Line 118 Line 210
  </subsection>   </subsection>
  </section>   </section>
   
    <section name="Advanced RAT">
    <pod file="../rat/lonratedt.pm" section="!NAME|SYNOPSUS|OVERVIEW" />
    </section>
   
  <section name="Roles Selection">   <section name="Roles Selection">
  <pod file="auth/lonroles.pm" section="!NAME|SYNOPSIS" />   <pod file="auth/lonroles.pm" section="!NAME|SYNOPSIS" />
  </section>   </section>

Removed from v.1.4  
changed lines
  Added in v.1.5


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>