Add audit events documentation.

doc/README.md

@@ -20,6 +20,7 @@
 - [System hooks](system_hooks/system_hooks.md) Let GitLab notify you when certain management tasks need to be carried out.
 - [Security](security/README.md) Learn what you can do to further secure your GitLab instance.
 - [Update](update/README.md) Update guides to upgrade your installation.
+- [Audit Events](administration/audit_events.md) Check how user access change in projects and groups.
 
 - [Branded login page](customization/branded_login_page.md) Change the login page appearance for your GitLab instance.
 - [Git Hooks](git_hooks/git_hooks.md) Advanced push rules for your project.

doc/administration/audit_events.md

+# Audit Events
+
+GitLab Enterprise Edition offers a way to view the changes made within the GitLab server as a help to system administrators.
+
+
+# Security Events
+
+| Security Event                 | Description                                                                                      |
+|--------------------------------|--------------------------------------------------------------------------------------------------|
+| User added to group or project | Notes the author of the change, target user                                                      |
+| User permission changed        | Notes the author of the change, original permission and new permission, target user              |
+
+
+# Audit Events in Project
+
+To view the Audit Events user needs to have enough permissions to view the project Settings page.
+
+Navigate to Project->Settings->Audit Events to view the Audit Events:
+
+![audit events project](audit_events_project.png)
+
+# Audit Events in Group
+
+To view the Audit Events user needs to have enough permissions to view the group Settings page.
+
+Navigate to Group->Settings->Audit Events to view the Audit Events:
+
+![audit events group](audit_events_group.png)