Differences between revisions 18 and 23 (spanning 5 versions)
Revision 18 as of 2020-01-31 18:36:10
Size: 5097
Editor: nodiscc
Comment: update link to redirected page
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,1)>>
Line 5: Line 4:
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. 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 7: Line 6:
{{{#!highlight cucumber {{{
Line 22: Line 21:
→ Documentation: [[AppArmor/Contribute/ImportProfileFromExtra]]
Line 24: Line 22:
{{{#!highlight cucumber {{{
Line 36: Line 34:
{{{#!highlight cucumber {{{
Line 51: Line 49:
→ Documentation: [[AppArmor/Contribute/Upstream]] → Documentation: [[AppArmor/Contribute]]
Line 53: Line 51:
{{{#!highlight cucumber {{{
Line 67: Line 65:
{{{#!highlight cucumber {{{
Line 79: Line 77:
{{{#!highlight cucumber {{{
Line 89: Line 87:
Documentation [[AppArmor/Contribute/Upstream]] Documentation [[AppArmor/Contribute]]
Line 91: Line 89:
{{{#!highlight cucumber {{{
Line 109: Line 107:
{{{#!highlight cucumber {{{
Line 125: Line 123:
{{{#!highlight cucumber {{{
Line 139: 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