Add docs for Profile > Preferences

Also converts doc/README.md to Unix line endings

3 files changed, 72 insertions, 35 deletions

diff --git a/doc/README.md b/doc/README.md
index 7a2181edded..451abf8b792 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -1,35 +1,36 @@
-# Documentation

-

-## User documentation

-

-- [API](api/README.md) Automate GitLab via a simple and powerful API.

-- [GitLab as OAuth2 authentication service provider](integration/oauth_provider.md). It allows you to login to other applications from GitLab.

-- [Importing to GitLab](workflow/importing/README.md).

-- [Markdown](markdown/markdown.md) GitLab's advanced formatting system.

-- [Permissions](permissions/permissions.md) Learn what each role in a project (guest/reporter/developer/master/owner) can do.

-- [Project Services](project_services/project_services.md) Integrate a project with external services, such as CI and chat.

-- [Public access](public_access/public_access.md) Learn how you can allow public and internal access to projects.

-- [SSH](ssh/README.md) Setup your ssh keys and deploy keys for secure access to your projects.

-- [Web hooks](web_hooks/web_hooks.md) Let GitLab notify you when new code has been pushed to your project.

-- [Workflow](workflow/README.md) Using GitLab functionality and importing projects from GitHub and SVN.

-

-## Administrator documentation

-

-- [Custom git hooks](hooks/custom_hooks.md) Custom git hooks (on the filesystem) for when web hooks aren't enough.

-- [Install](install/README.md) Requirements, directory structures and installation from source.

-- [Integration](integration/README.md) How to integrate with systems such as JIRA, Redmine, LDAP and Twitter.

-- [Issue closing](customization/issue_closing.md) Customize how to close an issue from commit messages.

-- [Libravatar](customization/libravatar.md) Use Libravatar for user avatars.

-- [Log system](logs/logs.md) Log system.

-- [Operations](operations/README.md) Keeping GitLab up and running

-- [Raketasks](raketasks/README.md) Backups, maintenance, automatic web hook setup and the importing of projects.

-- [Security](security/README.md) Learn what you can do to further secure your GitLab instance.

-- [System hooks](system_hooks/system_hooks.md) Notifications when users, projects and keys are changed.

-- [Update](update/README.md) Update guides to upgrade your installation.

-- [Welcome message](customization/welcome_message.md) Add a custom welcome message to the sign-in page.

-

-## Contributor documentation

-

-- [Development](development/README.md) Explains the architecture and the guidelines for shell commands.

-- [Legal](legal/README.md) Contributor license agreements.

-- [Release](release/README.md) How to make the monthly and security releases.
\ No newline at end of file
+# Documentation
+
+## User documentation
+
+- [API](api/README.md) Automate GitLab via a simple and powerful API.
+- [GitLab as OAuth2 authentication service provider](integration/oauth_provider.md). It allows you to login to other applications from GitLab.
+- [Importing to GitLab](workflow/importing/README.md).
+- [Markdown](markdown/markdown.md) GitLab's advanced formatting system.
+- [Permissions](permissions/permissions.md) Learn what each role in a project (guest/reporter/developer/master/owner) can do.
+- [Profile Settings](profile/profile.md)
+- [Project Services](project_services/project_services.md) Integrate a project with external services, such as CI and chat.
+- [Public access](public_access/public_access.md) Learn how you can allow public and internal access to projects.
+- [SSH](ssh/README.md) Setup your ssh keys and deploy keys for secure access to your projects.
+- [Web hooks](web_hooks/web_hooks.md) Let GitLab notify you when new code has been pushed to your project.
+- [Workflow](workflow/README.md) Using GitLab functionality and importing projects from GitHub and SVN.
+
+## Administrator documentation
+
+- [Custom git hooks](hooks/custom_hooks.md) Custom git hooks (on the filesystem) for when web hooks aren't enough.
+- [Install](install/README.md) Requirements, directory structures and installation from source.
+- [Integration](integration/README.md) How to integrate with systems such as JIRA, Redmine, LDAP and Twitter.
+- [Issue closing](customization/issue_closing.md) Customize how to close an issue from commit messages.
+- [Libravatar](customization/libravatar.md) Use Libravatar for user avatars.
+- [Log system](logs/logs.md) Log system.
+- [Operations](operations/README.md) Keeping GitLab up and running
+- [Raketasks](raketasks/README.md) Backups, maintenance, automatic web hook setup and the importing of projects.
+- [Security](security/README.md) Learn what you can do to further secure your GitLab instance.
+- [System hooks](system_hooks/system_hooks.md) Notifications when users, projects and keys are changed.
+- [Update](update/README.md) Update guides to upgrade your installation.
+- [Welcome message](customization/welcome_message.md) Add a custom welcome message to the sign-in page.
+
+## Contributor documentation
+
+- [Development](development/README.md) Explains the architecture and the guidelines for shell commands.
+- [Legal](legal/README.md) Contributor license agreements.
+- [Release](release/README.md) How to make the monthly and security releases.
diff --git a/doc/profile/preferences.md b/doc/profile/preferences.md
new file mode 100644
index 00000000000..0c12eb0c655
--- /dev/null
+++ b/doc/profile/preferences.md
@@ -0,0 +1,33 @@
+# Profile Preferences
+
+Settings in the **Profile > Preferences** page allow the user to customize
+various aspects of the site to their liking.
+
+## Application theme
+
+Changing this settings allows the user to customize the color scheme used for
+the navigation bar on the left side of the screen.
+
+The default is **Charcoal**.
+
+## Syntax highlighting theme
+
+Changing this setting allows the user to customize the theme used when viewing
+syntax highlighted code on the site.
+
+The default is **White**.
+
+## Behavior
+
+### Default Dashboard
+
+For users who have access to a large number of projects but only keep up with a
+select few, the amount of activity on the default Dashboard page can be
+overwhelming.
+
+Changing this setting to allows the user to redefine what their default
+dashboard will be. Setting it to **Starred Projects** will make that Dashboard
+view the default when signing in or clicking the application logo in the upper
+left.
+
+The default is **Projects**.
diff --git a/doc/profile/profile.md b/doc/profile/profile.md
new file mode 100644
index 00000000000..032d62cf884
--- /dev/null
+++ b/doc/profile/profile.md
@@ -0,0 +1,3 @@
+# Profile Settings
+
+- [Preferences](preferences.md)