URL: https://github.com/freeipa/freeipa/pull/520
Author: pvoborni
 Title: #520: Change README to use Markdown
Action: opened

PR body:
"""
So that it will be nicely formatted on FreeIPA Pagure landing page.
  https://pagure.io/freeipa

Some links were updated as other projects also moved to Pagure.io.

Temporary preview on: https://pagure.io/pvoborni-test
"""

To pull the PR as Git branch:
git remote add ghfreeipa https://github.com/freeipa/freeipa
git fetch ghfreeipa pull/520/head:pr520
git checkout pr520
From 773512bcacfac3b2847d952de81ede915eba841d Mon Sep 17 00:00:00 2001
From: Petr Vobornik <pvobo...@redhat.com>
Date: Tue, 28 Feb 2017 19:04:03 +0100
Subject: [PATCH] Change README to use Markdown

So that it will be nicely formatted on FreeIPA Pagure landing page.
  https://pagure.io/freeipa

Some links were updated as other projects also moved to Pagure.io.
---
 README    | 92 ---------------------------------------------------------------
 README.md | 74 ++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 74 insertions(+), 92 deletions(-)
 delete mode 100644 README
 create mode 100644 README.md

diff --git a/README b/README
deleted file mode 100644
index ad5b081..0000000
--- a/README
+++ /dev/null
@@ -1,92 +0,0 @@
-
-                               IPA Server
-
-  Overview
-  --------
-
-  FreeIPA allows Linux administrators to centrally manage identity,
-  authentication and access control aspects of Linux and UNIX systems
-  by providing simple to install and use command line and web based
-  managment tools.
-  FreeIPA is built on top of well known Open Source components and standard
-  protocols with a very strong focus on ease of management and automation
-  of installation and configuration tasks.
-  FreeIPA can seamlessly integrate into an Active Directory environment via
-  cross-realm Kerberos trust or user synchronization.
-
-  Benefits
-  --------
-
-  FreeIPA:
-  * Allows all your users to access all the machines with the same credentials
-    and security settings
-  * Allows users to access personal files transparently from any machine in
-    an authenticated and secure way
-  * Uses an advanced grouping mechanism to restrict network access to services
-    and files only to specific users
-  * Allows central management of security mechanisms like passwords,
-    SSH Public Keys, SUDO rules, Keytabs, Access Control Rules
-  * Enables delegation of selected administrative tasks to other power users
-  * Integrates into Active Directory environments
-
-  Components
-  ----------
-
-  The FreeIPA project provides unified installation and management
-  tools for the following components:
-
-  * LDAP Server - based on the 389 project (LDAP)
-    http://directory.fedoraproject.org/wiki/Main_Page
-
-  * KDC - based on MIT Kerberos implementation
-    http://k5wiki.kerberos.org/wiki/Main_Page
-
-  * PKI based on Dogtag project
-    http://pki.fedoraproject.org/wiki/PKI_Main_Page
-
-  * Samba libraries for Active Directory integration
-    http://www.samba.org/
-
-  * DNS Server based on BIND and the Bind-DynDB-LDAP plugin
-    https://www.isc.org/software/bind
-    https://fedorahosted.org/bind-dyndb-ldap
-
-
-  Project Website
-  ---------------
-
-  Releases, announcements and other information can be found on the IPA
-  server project page at <http://www.freeipa.org/>.
-
-  Documentation
-  -------------
-
-  The most up-to-date documentation can be found at
-  <http://freeipa.org/page/Documentation>.
-
-  Quick Start
-  -----------
-
-  To get started quickly, start here:
-  <http://www.freeipa.org/page/Quick_Start_Guide>
-
-  Licensing
-  ---------
-
-  Please see the file called COPYING.
-
-  Contacts
-  --------
-
-     * If you want to be informed about new code releases, bug fixes,
-       security fixes, general news and information about the IPA server
-       subscribe to the freeipa-announce mailing list at
-       <https://www.redhat.com/mailman/listinfo/freeipa-interest/>.
-
-     * If you have a bug report please submit it at:
-       <https://bugzilla.redhat.com>
-
-     * If you want to participate in actively developing IPA please
-       subscribe to the freeipa-devel mailing list at
-       <https://www.redhat.com/mailman/listinfo/freeipa-devel/> or join
-       us in IRC at irc://irc.freenode.net/freeipa
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1cbb49e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,74 @@
+FreeIPA Server
+==============
+
+FreeIPA allows Linux administrators to centrally manage identity,
+authentication and access control aspects of Linux and UNIX systems
+by providing simple to install and use command line and web based
+managment tools.
+
+FreeIPA is built on top of well known Open Source components and standard
+protocols with a very strong focus on ease of management and automation
+of installation and configuration tasks.
+
+FreeIPA can seamlessly integrate into an Active Directory environment via
+cross-realm Kerberos trust or user synchronization.
+
+## Benefits
+
+FreeIPA:
+
+* Allows all your users to access all the machines with the same credentials
+  and security settings
+* Allows users to access personal files transparently from any machine in
+  an authenticated and secure way
+* Uses an advanced grouping mechanism to restrict network access to services
+  and files only to specific users
+* Allows central management of security mechanisms like passwords,
+  SSH Public Keys, SUDO rules, Keytabs, Access Control Rules
+* Enables delegation of selected administrative tasks to other power users
+* Integrates into Active Directory environments
+
+## Components
+
+The FreeIPA project provides unified installation and management
+tools for the following components:
+
+* LDAP Server - based on the [389 project](http://www.port389.org/)
+* KDC - based on [MIT Kerberos](http://k5wiki.kerberos.org/wiki/Main_Page)
+  implementation
+* PKI based on [Dogtag project](http://pki.fedoraproject.org/wiki/PKI_Main_Page)
+* [Samba](http://www.samba.org/) libraries for Active Directory integration
+* DNS Server based on [BIND](https://www.isc.org/software/bind) and the
+  [Bind-DynDB-LDAP plugin](https://pagure.io/bind-dyndb-ldap)
+
+## Project Website
+
+Releases, announcements and other information can be found on the IPA
+server project page at http://www.freeipa.org/ .
+
+## Documentation
+
+The most up-to-date documentation can be found at
+http://freeipa.org/page/Documentation .
+
+## Quick Start
+
+To get started quickly, start here:
+http://www.freeipa.org/page/Quick_Start_Guide
+
+## Licensing
+
+Please see the file called COPYING.
+
+## Contacts
+
+* If you want to be informed about new code releases, bug fixes,
+  security fixes, general news and information about the IPA server
+  subscribe to the freeipa-announce mailing list at
+  https://www.redhat.com/mailman/listinfo/freeipa-interest/ .
+* If you have a bug report please submit it at:
+  https://pagure.io/freeipa/issues
+* If you want to participate in actively developing IPA please
+  subscribe to the freeipa-devel mailing list at
+  https://www.redhat.com/mailman/listinfo/freeipa-devel/ or join
+  us in IRC at <irc://irc.freenode.net/freeipa>
-- 
Manage your subscription for the Freeipa-devel mailing list:
https://www.redhat.com/mailman/listinfo/freeipa-devel
Contribute to FreeIPA: http://www.freeipa.org/page/Contribute/Code

Reply via email to