How to document requirements for an API systematically?
Posted
by
Heinrich
on Programmers
See other posts from Programmers
or by Heinrich
Published on 2012-09-01T14:15:09Z
Indexed on
2012/09/01
21:49 UTC
Read the original article
Hit count: 276
documentation
|api
I am currently working on a project, where I have to analyze the requirements of two given IT systems, that use cloud computing, for a Cloud API. In other words, I have to analyze what requirements these systems have for a Cloud API, such that they would be able to switch it, while being able to accomplish their current goals.
Let me give you an example for some informal requirements of Project A:
- When starting virtual machines in the cloud through the API, it must be possible to specify the memory size, CPU type, operating system and a SSH key for the root user.
- It must be possible to monitor the inbound and outbound network traffic per hour per virtual machine.
- The API must support the assignment of public IPs to a virtual machine and the retrieval of the public IPs.
- ...
In a later stage of the project I will analyze some Cloud Computing standards that standardize cloud APIs to find out where possible shortcomings in the current standards are. A finding could and will probably be, that a certain standard does not support monitoring resource usage and thus is not currently usable.
I am currently trying to find a way to systematically write down and classify my requirements. I feel that the way I currently have them written down (like the three points above) is too informal.
I have read in a couple of requirements enineering and software architecture books, but they all focus too much on details and implementation. I do really only care about the functionalities provided through the API/interface and I don't think UML diagrams etc. are the right choice for me. I think currently the requirements that I collected can be described as user stories, but is that already enough for a sophisticated requirements analysis? Probably I should go "one level deeper" ...
Any advice/learning resources for me?
© Programmers or respective owner