Menu

Help to proofread the QSMM package manual

2013-06-19
2015-09-30
1 2 > >> (Page 1 of 2)
  • Oleg Volkov

    Oleg Volkov - 2013-06-19

    The QSMM Project ( http://sourceforge.net/projects/qsmm/ ), which suggests a framework for development of intelligent systems, is looking for a serious person with very good knowledge of written English and some skills in C programming language, who will help to proofread the "QSMM Programmer Manual" (about 300 pages).

    If you feel confident that you can help, then reply to this post, write to the mailing list for QSMM users (which information page can be accessed from the above URL), or send me a private message.

    Oleg Volkov,
    a developer of QSMM

     
    • Robert Ellis

      Robert Ellis - 2015-04-22

      I can help. Eons ago I wrote compiler documentation. What would you like me to review?

       
      • Oleg Volkov

        Oleg Volkov - 2015-04-23

        Hello Robert,

        You could start with proofreading some parts of text in Chapter 6 [Miscellaneous Topics]: Section 6.1 [Random Number Generators] (the introductory text only), Subsection 6.1.1 [Creating a Random Number Generator], and Subsection 6.1.2 [Generating Random Numbers]. They are short and simple. However, one needs to proofread them.

        If you are willing to review these parts of text, to prevent overloading this forum thread with excessive technical details, I will give this information in a private message.

         
  • bryan barnes

    bryan barnes - 2013-11-18

    I am a technical writer, instructional and curriculum developer with documentation experience. I'd be glad to discuss your requirements and deliverables. thx bb

     
  • Oleg Volkov

    Oleg Volkov - 2014-07-30

    Bryan helped me to proofread the QSMM Project web site and some sections from Chapter 1 of the manual. His help is invaluable for me, especially proofreading and enhancing the style of web site content.

    However, because of a high workload at his place of employment, he could not proceed with the proofreading. The QSMM Project continues to look for a serious person, who will help to proofread the rest of the manual.

     
    • KBS

      KBS - 2014-07-30

      Hi
      I can help you in this. Pls share more details.

      Regards
      KBS

       
      • Oleg Volkov

        Oleg Volkov - 2015-03-17

        Hi

        The current version of the manual can be accessed from project home page http://qsmm.org/ (see the "Documentation" section). Corrections in the manual should be made in the source Texinfo file that can be downloaded from http://sourceforge.net/p/qsmm/code/HEAD/tree/trunk/doc/manual/qsmm-man.texi?format=raw . Regenerating HTML files is performed by the GNU Texinfo system. To recreate the PDF file, the TeX typesetting system is needed. Send a message if you need more information.

        Oleg

         
  • KBS

    KBS - 2014-08-04

    Hi

    http://qsmm.org/ is not accessible. Is there way out ?

     
    • Oleg Volkov

      Oleg Volkov - 2014-09-08

      Site http://qsmm.org/ is now accessible more reliably. I have changed the hosting provider.

       
  • sikes

    sikes - 2014-10-17

    Hi

    Are you still in need of a proofreader? If so I'd like to help out during my free time.

     
    • Oleg Volkov

      Oleg Volkov - 2015-03-30

      Hi

      Yes, I am in need of a proofreader. KBS (his messages are above) now helps me to proofread the manual, and I am grateful for his assistance! However, the process is going rather slowly and I would appreciate if someone else joined in.

      I check this forum occasionally, so if you (or next readers of this thread) are willing to help, it is better to send me the private message via SourceForge.net. If you send the message via this forum, I may not read it for a long time.

       
  • Luke Lynch

    Luke Lynch - 2015-03-30

    Hi,

    I'm not experienced with C programming languages, but I am a a fantastic proofreader.

    Please let me know if you'd like my assistance.

     
    • Oleg Volkov

      Oleg Volkov - 2015-04-03

      Hi

      Yes, I would like your assistance in the proofreading.

      We can start with the section 3.1 [Types of Storage] of the manual. You can view it at http://qsmm.org/doc/qsmm-man.html-node/Types-of-Storage.html or find in http://qsmm.org/doc/qsmm-man.pdf

      The documentation files were generated from the source ones by the Texinfo system. Here its homepage: https://www.gnu.org/software/texinfo/

      It would be better if you made corrections in the source documentation file. If you can do that, I will provide additional information about installing and setting up Texinfo.

      However, if you consider that it is difficult to use Texinfo, you can make corrections in the file Types-of-Storage.html itself.

      Please let me know your choice.

       
  • BillSV

    BillSV - 2015-04-09

    Hi there,

    I, like Luke Lynch, am not an experienced C programmer. But I'm extremely proficient in English and have a strange love of proofreading. So if I could help in any way, please contact me. If you would like me to follow the same instructions as Luke Lynch, just post a quick reply to let me know.

    In addition, I can help you on either a Mac or Linux, whichever you prefer.

    Thank you

     
    • Oleg Volkov

      Oleg Volkov - 2015-04-09

      Hi

      Yes, the help in the proofreading is highly appreciated. I posted Luke Lynch more detailed instructions but he did not reply yet. I can repost those instructions to you after adjusting them for Linux platform.

      Oleg

       
  • Oleg Volkov

    Oleg Volkov - 2015-05-21

    Luke Lynch and BillSV did not reply. KBS (Karuna Shankar) has proofread the section 3.1 [Types of Storage].

     
  • Anonymous

    Anonymous - 2015-08-24

    Hi,
    I would be happy to help with the proofreading. Let me know if you need help with this project or other similar projects.

     
    • Oleg Volkov

      Oleg Volkov - 2015-08-25

      Hi,
      Yes, I need help with proofreading/editing a manual for this project. The current working version of the manual is located at http://qsmm.org/doc/new/qsmm-man.html-node/ . Not all sections require the help: I am going to rewrite many of them, and some others were already proofread by volunteers who contacted me because of publication of the message in this forum.

       
  • Anonymous

    Anonymous - 2015-08-25

    Hi there,
    Okay. Thank you for the link. Let me know which sections require help and I'll get started editing them.

     
  • Anonymous

    Anonymous - 2015-08-25

    Hi there,
    Okay. Thank you for the link. Let me know which sections require help and I'll get started editing them.

     
    • Oleg Volkov

      Oleg Volkov - 2015-08-26

      Thank you for your willingness to help!
      I will send you details by a private message.

       
  • YvesL

    YvesL - 2015-09-04

    Hi Oleg
    If you are still looking for proof readers or editors, I would like to get involved.

     
    • Oleg Volkov

      Oleg Volkov - 2015-09-07

      Hello Yves,

      Yes, I am still looking for proofreaders/editors. However, I am not ready to assign you a piece of text for correction at the moment. Meirav helped with correcting several sections of the manual, and while reviewing her edits, I have realized that similar text fragments require correcting throughout the text. Thus, other sections that need proofreading/editing now have uncommitted changes.

      May I apply for your help in a week or so when I commit those changes to the source code repository and rebuild the documentation at the project web site?

       
      • YvesL

        YvesL - 2015-09-15

        Hi Oleg, sure thats fine. Let me know when you are ready to go again.

         
1 2 > >> (Page 1 of 2)

Log in to post a comment.