Differences between revisions 6 and 23 (spanning 17 versions)
Revision 6 as of 2015-01-28 15:37:22
Size: 4950
Editor: UlrikeUhlig
Comment: correct link for testing
Revision 23 as of 2020-02-01 13:11:36
Size: 4843
Editor: nodiscc
Comment: update links to redirected page
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
----
<<Navigation(siblings)>>
----
<<TableOfContents>>
Line 8: Line 4:
These user stories have been set up to check our documentation asnwers all possible probably issues Users, contributors, maintainers might face with AppArmor in Debian. These user stories have been set up to check that our documentation answers all possible probable issues which users, contributors, maintainers might face with '''AppArmor''' in Debian.
Line 10: Line 6:
{{{#!highlight cucumber {{{
Line 19: Line 15:
→ Documentation: [[AppArmor/PackageMaintainers]] → Usertag: "new-profile"
Line 21: Line 17:
{{{#!highlight cucumber → Usertag: "migrate-profile"

→ Documentation: [[AppArmor/Contribute/FirstTimeProfileImport]]


{{{
Line 30: Line 31:
→ Documentation [[AppArmor/PackageMaintainers#Test]] → Documentation [[AppArmor/Debug]]
Line 33: Line 34:
{{{#!highlight cucumber {{{
Line 48: Line 49:
→ Documentation: [[AppArmor/ContributeUpstream]] → Documentation: [[AppArmor/Contribute]]
Line 50: Line 51:
{{{#!highlight cucumber {{{
Line 53: Line 54:
     As a Debian contributor,      As a Debian user or contributor,
Line 62: Line 63:
→ Documentation: [[AppArmor/Contribute/Import|Updating a profile in Debian’s apparmor-profiles-extra package]] → Documentation: [[AppArmor/Contribute/MergeProfileFromUpstream|Updating a profile in Debian’s apparmor-profiles-extra package]]
Line 64: Line 65:
{{{#!highlight cucumber {{{
Line 76: Line 77:
{{{#!highlight cucumber {{{
Line 86: Line 87:
Documentation [[AppArmor/ContributeUpstream]] Documentation [[AppArmor/Contribute]]
Line 88: Line 89:
{{{#!highlight cucumber {{{
Line 106: Line 107:
{{{#!highlight cucumber {{{
Line 122: Line 123:
{{{#!highlight cucumber {{{
Line 125: Line 126:
     As a Debian contributor,      As a Debian user or contributor,
Line 136: Line 137:

----

CategorySystemSecurity

Translation(s): none

These user stories have been set up to check that our documentation answers all possible probable issues which users, contributors, maintainers might face with AppArmor in Debian.

Feature: Ship an existing AppArmor profile confining software S in the Debian package that ships S
  Scenario:
    As a Debian package maintainer,
    When I want to ship an AppArmor profile in package P, 
    Given this profile exists upstream or in the apparmor-profiles-extra package
    Then I need to be told how to do that.

→ Usertag: "new-profile"

→ Usertag: "migrate-profile"

→ Documentation: AppArmor/Contribute/FirstTimeProfileImport

Feature: Testing AppArmor confinement before uploading a new version of a package
  Scenario:
    As a Debian package maintainer,
    Given I ship an AppArmor profile in package P, 
    When I prepare an upload for a new upstream release,
    Then I want to check that it still works under AppArmor confinement. 

→ Documentation AppArmor/Debug

Feature: New AppArmor profile
  Scenario:
    As a Debian package maintainer or as a Debian contributor,
    Given that I have written or found an AppArmor profile for package P, 
    And this profile does not exist in apparmor-profiles-extra nor upstream,
    Then I need to be taught how to test the profile
    And I need to be taught to ask for a review of this profile
    And I need to be taught how to upstream this profile

→ Usertag "new-profile"

→ Documentation AppArmor/Debug

→ Documentation: AppArmor/Contribute

Feature: Update an AppArmor profile to include upstream improvements
  Scenario:
     As a Debian user or contributor,
     When I want an already packaged profile to be updated to the latest upstream version
     Then I need to be taught how to make the AppArmor team aware of my needs.

→ Usertag "merge-from-upstream"

→ Usertag "patch" with attached patch

→ Documentation: Updating a profile in Debian’s apparmor-profiles-extra package

Feature: Modify an already shipped AppArmor profile
  Scenario:
     As a Debian contributor,
     Given that an AppArmor profile is shipped in package P
     When I want to update that profile 
     And changes should be merged upstream and in the Debian package
     Then I need to know how to do that.

→ Usertag "modify-profile"

Feature: Upstream Debian changes made on an AppArmor profile we ship
  Scenario:
     As a Debian contributor,
     When I want to request that a profile which is shipped in Debian be updated upstream
     Then I need to be taught how to do that.

→ Usertag "merge-to-upstream"

Documentation AppArmor/Contribute

Feature: Find out if a problem with a confined software is AppArmor related
  Scenario:
      As a Debian user,
      Given I use a program that comes with an AppArmor profile,
      When this software does not behave as it should or crashes,
      Then I want to be taught how to diagnose whether AppArmor is involved
      And if that is the case, I want to be taught what to include in a bugreport and how I could fix the problem myself.

→ Usertag "help-needed", to request help for initial diagnosis

→ Usertag "buggy-profile" if AppArmor has been identified as culprit

→ Documentation: AppArmor/Reportbug

→ Documentation: AppArmor/Debug

Feature: Find out if a bug is AppArmor related
  Scenario:
     As a Debian package maintainer,
     Given I ship an AppArmor profile in package P I am maintaining, 
     When I receive a bug report that might be caused by AppArmor, 
     Then I want to be taught how to diagnose whether AppArmor is involved
     And if that is the case, I want to be taught how to put the problem under the pkg-apparmor team's radar.

→ Usertag "help-needed", to request help for initial diagnosis

→ Documentation: AppArmor/Debug

→ Usertag "buggy-profile" if AppArmor has been identified as culprit

Feature: Other AppArmor related problems
   Scenario:
     As a Debian user or contributor, 
     When I encounter problems with any AppArmor related tools (systemd, auditd, syslog, etc.),
     And I submit a bug report,
     Then I want to make the team aware of those bugs.

→ Usertags: will be refined as we go

→ Documentation: AppArmor/Reportbug

→ Currently, there is a usertag called "ux" for a bug related to auditd's formatting of AppArmor related messages and "platform" for #775331


CategorySystemSecurity