From 40074f49b94cff3a87fe05678d7fbfd5f855e46e Mon Sep 17 00:00:00 2001
From: Paul W. Frields <stickster@gmail.com>
Date: Apr 12 2018 21:00:02 +0000
Subject: Add independent doc for client setup


Signed-off-by: Paul W. Frields <stickster@gmail.com>

---

diff --git a/content/en-US/packaging_setup.adoc b/content/en-US/packaging_setup.adoc
new file mode 100644
index 0000000..4b0f2df
--- /dev/null
+++ b/content/en-US/packaging_setup.adoc
@@ -0,0 +1,56 @@
+= How do I setup my system for packaging work?
+
+All the tools you need to do packaging work in Fedora are freely available through the official Fedora repositories.
+
+
+[[install-the-packaging-client-tools]]
+== Install the packaging client tools
+
+The _fedora-packager_ package provides tools to help you setup and work with Fedora.
+When you install it, that package brings in everything necessary for general packaging work.
+Run the following command link:https://fedoramagazine.org/howto-use-sudo/[using sudo]:
+
+--------------------------------
+sudo dnf install fedora-packager
+--------------------------------
+
+[[configure-your-git]]
+== Configure git
+
+First, configure your user name and email address for Git.
+These are linked in each commit you do to Fedora packages.
+
+--------------------------------------------------
+git config --global user.name "John Doe"
+git config --global user.email johndoe@example.com
+--------------------------------------------------
+
+
+[[set-up-koji-client-config]]
+== Set up Koji client configuration
+
+Fedora and EPEL use the Fedora build system https://fedoraproject.org/wiki/Using_the_Koji_build_system[Koji] to build packages.
+Use the following command to https://fedoraproject.org/wiki/Using_the_Koji_build_system#Fedora_Account_System_.28FAS2.29_Setup[setup your Koji client configuration].
+Do not use _sudo_ or run this command as the _root_ user: 
+
+---------------------
+fedora-packager-setup
+---------------------
+
+[[get-a-kerberos-ticket]]
+== Get a Kerberos ticket
+
+You should know your Fedora Account System login name.
+Write this name to the _.fedora.upn_ file in your home directory, for use by additional tools.
+Substitute your FAS login name for _your-fasname_:
+
+-----------------------------------
+echo _your-fasname_ > ~/.fedora.upn
+-----------------------------------
+
+Then get a Kerberos ticket using this command.
+Use all uppercase letters for FEDORAPROJECT.ORG as shown:
+
+--------------------------------------
+kinit _your-fasname_@FEDORAPROJECT.ORG
+--------------------------------------