Fix references provided as lists of URLs

[Bryan D. Payne]

In the security guide, there are several areas where we list many references that are just URLs as a bulleted list at the end of a chapter. Such lists do not display properly in a printed version of the book (the URL may be masked and just the link name displayed). And these URLs can quickly go stale or become out of date.

Recommendation is to work to replace these references with published works that have longer lasting references. And then to improve how these are referenced within the book. This could be by either using a more traditional bibliography format at the end of each chapter or at the end of the entire book.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/129791

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/129791
Committed: https://git.openstack.org/cgit/openstack/security-doc/commit/?id=ce11cf8f0263babf650f019437272cb6daab3f58
Submitter: Jenkins
Branch: master

commit ce11cf8f0263babf650f019437272cb6daab3f58
Author: Joseph Robinson <email address hidden>
Date: Tue Oct 21 15:15:25 2014 +1000

    Security Guide reference list update

    Changing the bulleted list of reference URLs included in
    chapters 8, 14, 15, and 17 into a bibliography format.

    Change-Id: Ie3b061d74d806d01aa365712700bbc05b2792410
    backport: icehouse
    Partial-bug: #1343480

[Bryan D. Payne (bdpayne)]

Would be nice to fill out this ticket with details of where we need to make this fixes. Perhaps even break this into multiple tickets. That will help to make this more actionable.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/183953

[OpenStack Infra (hudson-openstack)]

Change abandoned by Lana Brindley (<email address hidden>) on branch: master
Review: https://review.openstack.org/183953
Reason: Patch needs to be done in RST.

[Priti Desai (priti-desai)]

This issue can be resolved if we can fix following issues:

(1) This list of sections has a separate section called "References":

http://docs.openstack.org/security-guide/data-processing/configuration-and-hardening.html
http://docs.openstack.org/security-guide/management/continuous-systems-management.html
http://docs.openstack.org/security-guide/management/management-interfaces.html

Lets be consistent and convert the "References" section into "Bibliography".

(2) Also, run a web crawler against entire guide to find dead URLs and fix them.

(3) Optional, reapply this patch https://review.openstack.org/183953

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/275963

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/275963
Committed: https://git.openstack.org/cgit/openstack/security-doc/commit/?id=407f8262d2beae144b88b5322c3990d5622b4233
Submitter: Jenkins
Branch: master

commit 407f8262d2beae144b88b5322c3990d5622b4233
Author: Priti Desai <email address hidden>
Date: Wed Feb 3 14:42:55 2016 -0800

    Converting references to bibliography

    Converting "References" to "Bibliography":

    http://docs.openstack.org/security-guide/data-processing/configuration-and-hardening.html
    http://docs.openstack.org/security-guide/management/continuous-systems-management.html
    http://docs.openstack.org/security-guide/management/management-interfaces.html

    Also, reapplying this patch https://review.openstack.org/183953,
    fixing python paste link.

    Change-Id: Ibab3bfe92192e2d29b0a102829a7a3dcde73e7ae
    Partial-Bug: #1343480

[Priti Desai (priti-desai)]

After running Integrity (web crawler) against openstack security guide, found a few dead links (404 not found):

(1) At http://docs.openstack.org/security-guide/compute/hypervisor-selection.html, https://www.kernel.org/doc/Documentation/cgroups/cgroups.txt is dead, replace it with https://www.kernel.org/doc/Documentation/cgroup-v1/cgroups.txt

(2) At http://docs.openstack.org/security-guide/compliance/overview.html, http://www.aicpa.org/InterestAreas/InformationTechnology/Resources/TrustServices/Pages/Trust%20Services%20Principles%E2%80%94An%20Overview.aspx is dead, replace it with http://www.aicpa.org/interestareas/informationtechnology/resources/soc/trustservices/pages/trust%20services%20principles—an%20overview.aspx

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/276491

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/276491
Committed: https://git.openstack.org/cgit/openstack/security-doc/commit/?id=f9d3622921bc0f87ee5f71e9ea0fa7940d980fe1
Submitter: Jenkins
Branch: master

commit f9d3622921bc0f87ee5f71e9ea0fa7940d980fe1
Author: Priti Desai <email address hidden>
Date: Thu Feb 4 15:04:43 2016 -0800

    Fixing broken links

    Fixing references which were dead links at:

    http://docs.openstack.org/security-guide/compute/hypervisor-selection.html
    http://docs.openstack.org/security-guide/compliance/overview.html

    Change-Id: I88254df5d98705285bce7a7159373a2ee40350df
    Closes-bug: #1343480