You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@kibble.apache.org by GitBox <gi...@apache.org> on 2020/05/31 12:47:20 UTC
[GitHub] [kibble] sharanf commented on a change in pull request #11: Create usecases.rst
sharanf commented on a change in pull request #11:
URL: https://github.com/apache/kibble/pull/11#discussion_r432942788
##########
File path: docs/source/usecases.rst
##########
@@ -0,0 +1,114 @@
+Use Cases
+========================
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+
+**********************
+Add an Organisation
+**********************
+This use case describes the process of adding an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in
+
+Flow of Events:
+ 1. The use case starts when the user is on the Organisation tab.
+ 2. The system loads any previously created organisations and the form to create a new organisation
+ 3. The user can enter an organisation name, description, and ID.
+ 4. The system will verify the information.
+ 5. The system will add the new organisation.
+ 6. The system will then display the new organisation along with any existing organisations.
+
+Exception Scenario:
+ The user does not enter an organisation name or description.
+
+Post Conditions:
+ The user creates the organisation or leaves the page.
+
+
+**********************
+Add a View
+**********************
+This use case describes the process of adding a view to an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in and has an organisation created
+
+Flow of Events:
+ 1. The use case starts when the user is on the Views tab.
+ 2. The user will click on the "Create a new view" button.
+ 3. The system loads the form to create a new view.
+ 4. The user will information needed to create the view.
Review comment:
Minor typing mistake. I think this should read 'The user will enter the information needed to create the view'
##########
File path: docs/source/usecases.rst
##########
@@ -0,0 +1,114 @@
+Use Cases
+========================
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+
+**********************
+Add an Organisation
+**********************
+This use case describes the process of adding an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in
+
+Flow of Events:
+ 1. The use case starts when the user is on the Organisation tab.
+ 2. The system loads any previously created organisations and the form to create a new organisation
+ 3. The user can enter an organisation name, description, and ID.
+ 4. The system will verify the information.
+ 5. The system will add the new organisation.
+ 6. The system will then display the new organisation along with any existing organisations.
+
+Exception Scenario:
+ The user does not enter an organisation name or description.
+
+Post Conditions:
+ The user creates the organisation or leaves the page.
+
+
+**********************
+Add a View
+**********************
+This use case describes the process of adding a view to an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in and has an organisation created
+
+Flow of Events:
+ 1. The use case starts when the user is on the Views tab.
+ 2. The user will click on the "Create a new view" button.
+ 3. The system loads the form to create a new view.
+ 4. The user will information needed to create the view.
+ 5. The system will verify the information.
+ 6. The system will add the new view.
+ 7. The system will then display the new view along with any existing views.
+ 8. The user with then be able to edit or delete the view.
+
+Exception Scenario:
+ The user does not enter a view name.
+
+Post Conditions:
+ The user creates the source or leaves the page.
+
+
+**********************
+Add a Source
+**********************
+This use case describes the process of adding a source to an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in and has an organisation created
+
+Flow of Events:
+ 1. The use case starts when the user is on the Sources tab.
+ 2. The system loads any existing sources and the form to create a new source.
+ 3. The user will select a source type from the list provided.
+ 4. The user will enter a source URL/ID and a username and password if needed.
+ 5. The system will verify the information.
+ 6. The system will add the new source.
+ 7. The system will then display the new source along with any existing sources.
+ 8. The user with then have to run the kibble scanner to process the new source.
Review comment:
Minor typing mistake. I think this should say 'The user will then have to run the kibble scanner to process the new source'
##########
File path: docs/source/usecases.rst
##########
@@ -0,0 +1,114 @@
+Use Cases
+========================
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+
+**********************
+Add an Organisation
+**********************
+This use case describes the process of adding an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in
+
+Flow of Events:
+ 1. The use case starts when the user is on the Organisation tab.
+ 2. The system loads any previously created organisations and the form to create a new organisation
+ 3. The user can enter an organisation name, description, and ID.
+ 4. The system will verify the information.
+ 5. The system will add the new organisation.
+ 6. The system will then display the new organisation along with any existing organisations.
+
+Exception Scenario:
+ The user does not enter an organisation name or description.
+
+Post Conditions:
+ The user creates the organisation or leaves the page.
+
+
+**********************
+Add a View
+**********************
+This use case describes the process of adding a view to an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in and has an organisation created
+
+Flow of Events:
+ 1. The use case starts when the user is on the Views tab.
+ 2. The user will click on the "Create a new view" button.
+ 3. The system loads the form to create a new view.
+ 4. The user will information needed to create the view.
+ 5. The system will verify the information.
+ 6. The system will add the new view.
+ 7. The system will then display the new view along with any existing views.
+ 8. The user with then be able to edit or delete the view.
Review comment:
Minor typing mistake. I think this should say 'The user will then be able to edit or delete the view'
##########
File path: docs/source/usecases.rst
##########
@@ -0,0 +1,114 @@
+Use Cases
+========================
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+
+**********************
+Add an Organisation
+**********************
+This use case describes the process of adding an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in
+
+Flow of Events:
+ 1. The use case starts when the user is on the Organisation tab.
+ 2. The system loads any previously created organisations and the form to create a new organisation
+ 3. The user can enter an organisation name, description, and ID.
+ 4. The system will verify the information.
+ 5. The system will add the new organisation.
+ 6. The system will then display the new organisation along with any existing organisations.
+
+Exception Scenario:
+ The user does not enter an organisation name or description.
+
+Post Conditions:
+ The user creates the organisation or leaves the page.
+
+
+**********************
+Add a View
+**********************
+This use case describes the process of adding a view to an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in and has an organisation created
+
+Flow of Events:
+ 1. The use case starts when the user is on the Views tab.
+ 2. The user will click on the "Create a new view" button.
+ 3. The system loads the form to create a new view.
+ 4. The user will information needed to create the view.
+ 5. The system will verify the information.
+ 6. The system will add the new view.
+ 7. The system will then display the new view along with any existing views.
+ 8. The user with then be able to edit or delete the view.
+
+Exception Scenario:
+ The user does not enter a view name.
+
+Post Conditions:
+ The user creates the source or leaves the page.
+
+
+**********************
+Add a Source
+**********************
+This use case describes the process of adding a source to an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in and has an organisation created
+
+Flow of Events:
+ 1. The use case starts when the user is on the Sources tab.
+ 2. The system loads any existing sources and the form to create a new source.
+ 3. The user will select a source type from the list provided.
+ 4. The user will enter a source URL/ID and a username and password if needed.
+ 5. The system will verify the information.
+ 6. The system will add the new source.
+ 7. The system will then display the new source along with any existing sources.
+ 8. The user with then have to run the kibble scanner to process the new source.
+
+Exception Scenario:
+ The user does not enter a source URL/ID.
+
+Post Conditions:
+ The user creates the source or leaves the page.
+
+
+**********************
+Add a User
+**********************
+This use case describes the process of adding a user to an organisation
+
+Actors:
+ User
+
+Precondition:
+ User is logged in and has an organisation created
+
+Flow of Events:
+ 1. The use case starts when the user is on the Users tab.
+ 2. The system loads the form to invite a new member and the current membership of the organisation.
Review comment:
This isn't very clear. If the invitation to become a member also includes becoming a member of the organisation then it could be rephrased as something like 'The system loads the form to invite a new member to have access and also become a member of the selected organisation'
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org