Menu

Comments on Software Requirement Specificatio

chrisy_tl
2008-02-15
2012-11-13
  • chrisy_tl

    chrisy_tl - 2008-02-15

    I have uploaded Software Requirement Specification for Notepad++ here:
    http://sourceforge.net/tracker/index.php?func=detail&aid=1894178&group_id=95717&atid=612384

    I would appreciate your comments on this document.

    I thank beforehand.

     
    • chrisy_tl

      chrisy_tl - 2008-02-20

      Hello everyone,

      thank you very much for your contributing to this interesting discussion. Am sorry for not joining the discussion much earlier.
      Brief history:
      In my Introduction to software engineering (ISE) lessons we had a lecture on Software Requirement Specifications (SRS). In this course we were introduced to Open Source Software (OSS) and how it works and asked to make a contribution as part of our course work. It happened that i have been using Notepad++ for sometime now and it is open source so i decided to write and contribute this SRS.
      The discussion here tells me that OSS is a complicated environment (in licensing terms) and i have a lot to learn. Pshute, Bravo! i realized that most of the brilliant OSS developers never had or boast of so call university degrees, they just make good software for all to benefit!
      About the SRS document. I wrote it according to a template we were given. I found the following sources very useful in writing the different sections; Notepad++ website (which i must say is very comprehensive and useful for Notepad++ users), the wiki at wikipedia, readme files, etc. However, its not perfect and i intend to be refining it as time goes on so that we Notepad++ will have additional material to use.

      Fidvo and donho and Pshute: you are right about the usages of the term "Freeware".
      Having done a bit of reading and asking, i learnt that the ideological debate sorrounding "Free", "Open", "Libre" is never ending. Fidvo and donho; should i go ahead with replacing the term freeware with Free Software? if this suits all in the project that's fine by me. Pshute thanks a lot for spotting some of the errors.

      I will implement your suggestions and upload a new version. I previously uploaded the document using the tracker. Now i have seen many options to upload the SRS. I will upload the new version at "Documentation" > "Submit". Is that Ok?
      Thanks a lot for taking your time to read and comment on the document.

       
      • fidvo

        fidvo - 2008-02-20

        > should i go ahead with replacing the term freeware with Free Software?

        That would be my suggestion.  It's clear, accurate, and precise to those to whom it matters, and although some people might mistake the term "Free Software" for "Freeware", those people are ones for whom the distinction doesn't matter, namely people who just want a free text editor and don't care about making any modifications to its source code.

         
    • pshute

      pshute - 2008-02-18

      I never expected you to come up with something so long. Here are some thoughts:

      - By "Software Requirement Specification" I assumed you meant something like just your section 2.4.  I had not read http://en.wikipedia.org/wiki/Software_Requirements_Specification then, so now I know.
      - What's this document for, and what would you like us to do with it?  It looks like the kind of thing you might write before the software is written.
      - While there are some useful references to existing documentation, I don't understand how much of this document would be of much use beyond the documentation we already have.
      - There's also an advanced find/replace (control+r).
      - The English needs tweaking here and there.
      - Is a GPL licence really about security?
      - You mention freeware in several places.  Is Open Source really the same thing?
      - You mention 4.4MB of free disk space, then imply that 4.4MB of RAM is used.
      - I don't understand what a functional requirement really is, but it looks like you only found one feature that had any.  Why not just says "None" for the others?  I prefer short documents.
      - Is this a school project or a project contribution?

      Forgive me if I've misunderstood what the document is about.  I never went to software engineer school.

       
      • fidvo

        fidvo - 2008-02-18

        - You mention freeware in several places. Is Open Source really the same thing?

        It gets even more complicated than that, because it's licensed under the GPL, so technically it's "Free Software" rather than "Open Source".  While I, like most people, consider Free Software to be a subcategory of Open Source, those responsible for the GPL consider the two to be mutually exclusive.

        For the sake of precision, I suggest using the term "Free Software" to describe anything licensed under the GPL.  That way, everyone's happy.

         
        • Don HO

          Don HO - 2008-02-19

          > It gets even more complicated than that, because it's licensed under the GPL,
          > so technically it's "Free Software" rather than "Open Source".

          True.

          > While I, like most people, consider Free Software to be a subcategory of Open Source,
          > those responsible for the GPL consider the two to be mutually exclusive.

          I don't think "subcategory" is a apropriate term.
          Without Free Software movement, open source phenomen may not exist.
          IMO, Free Software is rather the "source" of open source than a subcategory of open source.

          Don