mobrien / infra-docs

Forked from infra-docs 3 years ago
Clone
.gitignore
2-factor.rst
README
accountdeletion.rst
ansible.rst
apps-fp-o.rst
arm.rst
askbot.rst
badges.rst
basset.rst
bastion-hosts-info.rst
bladecenter.rst
blockerbugs.rst
bodhi.rst
bugzilla.rst
cloud.rst
contenthosting.rst
copr.rst
cyclades.rst
darkserver.rst
database.rst
datanommer.rst
denyhosts.rst
departing-admin.rst
dns.rst
fas-notes.rst
fas-openid.rst
fedmsg-certs.rst
fedmsg-gateway.rst
fedmsg-introduction.rst
fedmsg-irc.rst
fedmsg-relay.rst
fedmsg-websocket.rst
fedocal.rst
fedora-releases.rst
fedorahosted-fedmsg.rst
fedorahosted-project-cleanup.rst
fedorahosted-repo-setup.rst
fedorahosted.rst
fedorahostedrename.rst
fedorapackages.rst
fedorapastebin.rst
fedorawebsites.rst
fmn.rst
freemedia.rst
freenode-irc-channel.rst
gather-easyfix.rst
github.rst
gitweb.rst
guestdisk.rst
guestedit.rst
guestmigrate.rst
haproxy.rst
hosted_git_to_svn.rst
hotfix.rst
ibm-drive-replacement.rst
ibm_rsa_ii.rst
infra-git-repo.rst
infra-hostrename.rst
infra-raidmismatch.rst
infra-retiremachine.rst
infra-sop.rst
infra-yubikey.rst
infra-yum.rst
iscsi.rst
kerneltest-harness.rst
kickstarts.rst
koji-builder-setup.rst
koji.rst
koschei.rst
linktracking.rst
mailman.rst
making-ssl-certificates.rst
massupgrade.rst
mastermirror.rst
memcached.rst
mirrorhiding.rst
mirrormanager-S3-EC2-netblocks.rst
mirrormanager.rst
mote.rst
nagios.rst
netapp.rst
new-hosts.rst
nonhumanaccounts.rst
nuancier.rst
openvpn.rst
orientation.rst
outage.rst
packagedatabase.rst
pesign-upgrade.rst
planetsubgroup.rst
privatefedorahosted.rst
publictest-dev-stg-production.rst
rdiff-backup.rst
requestforresources.rst
resultsdb.rst
reviewboard.rst
scmadmin.rst
selinux.rst
sigul-upgrade.rst
sshaccess.rst
sshknownhosts.rst
staging-infra.rst
staging.rst
stagingservers.rst
status-fedora.rst
syslog.rst
taskotron.rst
torrentrelease.rst
turbogears.rst
unbound.rst
virt-image.rst
virt-notes.rst
virtio.rst
voting.rst
wiki.rst
zodbot.rst
README
infrastructure documents

This repository is for the infrastructure documentation and SOPs(Standard
Operating Procedures). These explain what we do, when we do it and, often,
why we do it.

== Cloning this repo ==

 If you plan to push changes (write) to this repo: 

 login to batcave01.phx2.fedoraproject.org

 git clone /git/infra-docs/

 If you simply want to read or don't have access to push:

 git clone https://infrastructure.fedoraproject.org/infra/infra-docs.git/

git grep is your friend in this dir.
Files should be in text.
they will be outputted to:

https://infrastructure.fedoraproject.org/infra/docs/

Information to include:

.. title: <Title of document>
.. slug: <the filename>
.. date: <Date created in YYYY-MM-DD>
.. lastupdate: <Date last updated in YYYY-MM-DD>
.. taxonomy: <Who is this doc for?>

Migration from the Wiki:
==============

For each SOP:

1. Copy the content out of the wiki version into a text file.
  a good way to do this is to run:

  links -dump $url > filename.txt

2. Update or clean up any wording that should be cleaned up or changed.

3. Commit to new repo and push.

4. Change the wiki page to note that the SOP has been converted and redirect
to a    wiki page that explains about the git repo and how to access it and/or a
link to that  particular sop.