.
FRDCSA | minor codebases | The FRDCSA Book
Homepage

[Project image]
The FRDCSA Book

Jump to: Project Description | Parent Description

Project Description

To quote from Zlatan's description of the contents of the book:

      The first thing that comes to mind as far as having a proper structure
      and layout for the FRDCSA book, is to have a properly written
      introduction. What I was thinking in the first place was as follows:

      * The book should be divided into two main parts.
      * The first part containing technical and non-technical
      introductions, goals of the project, importance of the project,
      technical concept descriptions, technical system diagrams,
      technical project structure, and ofcourse the introduction should
      have information about the author of the system, yourself.
      * The second part of the book contains the practical use of the
      FRDCSA system, from its use on the command line, and getting
      practical things done with it, technical tutorials, to describing
      of how the system works internally, in order to better encourage
      those interested to contribute to the project. Not to forget how
      to present to the user how to setup the system on their own server
      step-by-step. (this always worked well for reader like myself,
      once I'm given a good introduction, system diagrams, and all what
      I mentioned above, it encourages me and certainly gives enough
      good starting information to get involved in a project for which I
      never knew how it worked).
      * So, always remember, the book has to be to the point, and not a
      bunch of little code snippets, information snippets, fragmented
      system diagrams, etc. Information needs to be presented in, as I
      would call it "digestible and delicious chunks".
      o Needs to contain practical information, as I mentioned,
      system diagrams, good introductions (both technical and
      non-technical), concepts descriptions, not too many abstract
      descriptions as shown on the website, etc.
      o The book must have little abstract information, most of it
      just has to be to the point.
      o Has to have user-friendly technical tutorials such as
      setting up the system on your own server, interfacing to the
      system, doing cool or useful things with the system, etc.
      * The practicality approach is what encourages users/developers who
      either just heard of FRDCSA, or never heard of it at all, to
      actually start using the system as soon as possible without the
      frustration of simply going to your website, seeing all of the
      abstract information, and then as a result getting frustrated and
      never coming back again.
    


This page is part of the FWeb package.
Last updated Sat Oct 26 16:48:30 EDT 2019 .