Requirment specification tool for small scale projets (free and open source)

Good afternoon, 

I am trying to formalise my work as part of a new role in a new company. The role was vacant for a long time and there is not much structure around me. I am trying my best to manage projects and avoid scope creeps by drafting requirements based on the discussions I have with my internal customers. Discussions are very often fuzzy and it is not rare that after a month, something comes up on the table, because the internal customer only formulated his wish orally in a corridor and thought I accounted on his comments. My background is very generalist, and  I am looking for a low cost, easy to use solution, that can be understood by a wide range of staff. I guess that if money and time were not an issue I would onboard using IBM rational DOORS, but price is too prohibitive.

I have tried to share the spreadsheets that contains the requirements, but this is always ignored. Also the use of the spreadsheet is not convenient and quite segregated from my other working tools.

I am doing mostly hardware design, but also some software.

I am therefore looking for a software solution that would:

1) help to capture the requirement specifications

2) allow to share the requirements with the customer

3) Have a freeze of the requirement, agreed with the customer.

4) Have a validation plan

5) Have some compatibility with other project management tools (e.g. MS Project)

6) Ideally open source and maintained

7) Ideally Free, or small fee license

Do you have any suggestions?

Parents
  • Hi all, 

    thank you for your replies. I am fully aware the main issue is the lack of process in my company. On many aspects I would say. I am not here to bash on my employer who hired me couple of months ago. I know the main issue is that people expect miracles without following best practice. This is due to that there has been minimal investment in many aspects of the business. Most of the staff is either not technical, or operating as test technicians. They need replacement parts on systems that fails, they need a new measurement instrument but they have no clue on the physics involved (optic/acoustic/vibration/shock/temperature...). They just need something that look like what they have at the moment. Their criteria are not defined. It is also difficult to schedule meetings them, for more than 30mins.


    I have already made some spreadsheets to capture the systems requirements. As some of you mentioned, one issue is that this is ignored. And the cause is that no one has really been educated to this. I think it will come with time but I have flagged two other issues with spreadsheets: 

    1) lack of formalism in regard to how you capture the requirements, which enable ways to write them wrongly : e.g. I can ask a technician to review the requirements I drafted based on the conversation we have in the lab. And he may add: "there  should be a way to fix this device to this support using a plastic or ss bracket", rather than: "the device shall be mounted on the system using a bracket" and "the mounting bracket shall not corrode while the system is in operation"
    If there was a tool to avoid to write multiple requirements in one, that would be ideal.

    2) Spreadsheets are messy, not fault proof and hard to maintain.
       Anyone who did a bit of oriented object may understand what I mean. Or anyone who deleted a column in Excel which was link to some formulae will concur with me. Also any improvement of the spreadsheet is generally undocumented, and hard to implement for all other project spreadsheets.
    One main issue I have had was numbering requirements, or reordering them. 


    Through my research, I found a file format call reqIF. I will have a deeper look at it. It seems that Eclipse has something call ProR to edit such files (https://www.reqif.academy/library/books/handbook/?p=sec-rmf_derivatives.html). This is something I might explore in the future. 

    For other aspects of project planning, I have now access to MS projects, and I am self-training on it. 

    PS: Not so satirical, but I joined as an electromechanical engineer, I was given a desk, a laptop and solder iron. trackability of legacy projects from my predecessor was inexistent, and I am still running in the labs after screwdrivers Stuck out tongue.

  • ReqIf is a transfer format. I've used it to transfer requirement sets between different tools and different databases with the same tool. It is not without it's limitations. Mostly that it doesn't handle deletions very well.

    Given that Eclipse is free, its worth giving it a try. I had not come across that tool.

    At risk of someone throwing things at me, but there is also ISO/IEC/IEEE 15288: 2015 - System and Software Life Cycle Processes which is also available as the INCOSE Systems Engineering Handbook. The contains a lot of good detail about how systems engineering processes should work. You will also find supporting material in the SEBoK (sebokwiki.org)

    There is also the INCOSE Guide to Writing Requirements which has some good practices. the useful thing with this guide is that it defines testable criteria for checking a requirement. Some tools even automate some of these checks now.

    What I've seen done is that during a peer review, the checklist is used against each requirement. In theory the person preparing the requirements could use the same checklist to check their work before submitting. We essentially had the checklist incorporated into our process.

    A lot of its is practice and training. Even with experienced requirements engineers, if the tool pushes you into writing multiple requirements in an object, they will. Using MS Word tends to cause this behaviour. But sometimes is difficult to write a single atomic requirement that is complete, testable, concise, which is also where you see multiple requirements being written. 

    Regards,

    Mark

Reply
  • ReqIf is a transfer format. I've used it to transfer requirement sets between different tools and different databases with the same tool. It is not without it's limitations. Mostly that it doesn't handle deletions very well.

    Given that Eclipse is free, its worth giving it a try. I had not come across that tool.

    At risk of someone throwing things at me, but there is also ISO/IEC/IEEE 15288: 2015 - System and Software Life Cycle Processes which is also available as the INCOSE Systems Engineering Handbook. The contains a lot of good detail about how systems engineering processes should work. You will also find supporting material in the SEBoK (sebokwiki.org)

    There is also the INCOSE Guide to Writing Requirements which has some good practices. the useful thing with this guide is that it defines testable criteria for checking a requirement. Some tools even automate some of these checks now.

    What I've seen done is that during a peer review, the checklist is used against each requirement. In theory the person preparing the requirements could use the same checklist to check their work before submitting. We essentially had the checklist incorporated into our process.

    A lot of its is practice and training. Even with experienced requirements engineers, if the tool pushes you into writing multiple requirements in an object, they will. Using MS Word tends to cause this behaviour. But sometimes is difficult to write a single atomic requirement that is complete, testable, concise, which is also where you see multiple requirements being written. 

    Regards,

    Mark

Children
No Data