1

Topic: SRS Document

Software Requirements Specification Document for GParted Live 0.6.0-1

http://users.auth.gr/~vkaratzi/Software … arted.docx
http://users.auth.gr/~vkaratzi/Software … Parted.pdf

I grant permission to modify, add or delete stuff from the SRS Document.


@Moderators - Developers: Please download the files and store them somewhere else cause these links won't be up forever.

2

Re: SRS Document

Thank you for creating these documents.  I have downloaded the documentation and hope to review it in the next week or so.

3

Re: SRS Document

You've done quite a lot of work to gather together information on GParted in one document.  Kudos to you.  smile

Following are some comments I had after reading the document:

1)  Internet communication is available

In section 4.4 - Communication Interfaces, it is mentioned that GParted Live does not support any kind of network or Internet communication.  Although such communication is not obvious, it is available.

You can configure a network interface IP address with either:
   dhclient eth0
or
   ifconfig and route commands and remember to edit /etc/resolve.conf.

This would permit adding extra package repositories to /etc/apt/sources.list and then updating and installing new packages with:
   apt-get update
   apt-get install some-package-name

2)  Would you consider releasing your document under a free documentation license?

I did not observe a documentation license in the documentation.  The GParted Manual is released under the GNU Free Documentation License v1.2 or higher.  With such a license, others are permitted to alter and reproduce the documentation.

Perhaps you would consider a free documentation license, such as GNU FDL?

You can read more about about the the need for free documentation at the following link:
Why Free Software needs Free Documentation

3)  Would you consider placing your document in a free documentation format?

As far as I know, both .pdf and .docx are effectively proprietary formats.  At least I am not aware of free software that supports all the editing features of these formats.  In order for other free documentation persons to easily update the document, the source format needs to be one that is fully editable with free software.

The GParted Manual is written in DocBook/XML, though there are other formats that would be considered a free documentation format too.

4

Re: SRS Document

1)OK, maybe I can change the document in that part. I will try to do that shortly.
2)Sure, I don't mind. What to I need to do in the document? Where do I need to write what in order for the document to be released under GNU FDL?
3)Since i currently use proprietary formats, the only "easy" solution I can think of is converting the .docx to .odt from OpenOffice. Is this OK? I don't think I can convert to DocBook/XML:(

5

Re: SRS Document

vkaratzi wrote:

2)Sure, I don't mind. What to I need to do in the document? Where do I need to write what in order for the document to be released under GNU FDL?

If I recall I think that for shorter documents, such as the SRS you created, you can simply add a paragraph similar to the one at the beginning of the GParted Manual.

Please do read more about the GNU FDL because I am not a lawyer and I do not claim to understand all the nuances of licensing.

vkaratzi wrote:

3)Since i currently use proprietary formats, the only "easy" solution I can think of is converting the .docx to .odt from OpenOffice. Is this OK? I don't think I can convert to DocBook/XML:(

In my opinion the .odt format from OpenOffice should suffice.  smile

6

Re: SRS Document

The new files are up with the changes:

http://users.auth.gr/~vkaratzi/Software … Parted.doc
http://users.auth.gr/~vkaratzi/Software … arted.docx
http://users.auth.gr/~vkaratzi/Software … Parted.odt
http://users.auth.gr/~vkaratzi/Software … Parted.pdf

Hope everything is OK!

7

Re: SRS Document

Thank you for the updates.  I hope to re-read the document in the next few days.

8

Re: SRS Document

Hi vkaratzi,

I have re-read the document and think it could be useful for others and would like to post a link to it.

Would it be okay if I add a link to the GParted documentation page to your document?

9

Re: SRS Document

Yes, absolutely. But it would be best if you put the files somewhere else for download, because in a few months I will have finished the studies of my department and my username will be deleted along with the files.

10

Re: SRS Document

I have added the PDF version of the SRS document to the documentation page.

11

Re: SRS Document

very nice, thanks!:)