Skip to content

Docs: Relabel pages to new top-level "Reference/Policies and legal documents" (Diátaxis) #9916

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
4 changes: 2 additions & 2 deletions docs/user/abandoned-projects.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Policy for Abandoned Projects
=============================
Abandoned projects policy
=========================

This policy describes the process by which a Read the Docs project :term:`slug` may be changed.

Expand Down
7 changes: 1 addition & 6 deletions docs/user/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -110,6 +110,7 @@ to help you create fantastic documentation for your project.
/server-side-search/api
/reference/features
/server-side-search/syntax
/reference/policies


Read the Docs feature overview
Expand Down Expand Up @@ -307,10 +308,6 @@ of Read the Docs and the larger software documentation ecosystem.
:hidden:
:caption: About Read the Docs

security
dmca/index
abandoned-projects
unofficial-projects
changelog

about
Expand All @@ -321,8 +318,6 @@ of Read the Docs and the larger software documentation ecosystem.
advertising/index
sponsors

legal/index

Developer Documentation <https://dev.readthedocs.io>
glossary
gsoc
28 changes: 0 additions & 28 deletions docs/user/legal/index.rst

This file was deleted.

16 changes: 15 additions & 1 deletion docs/user/legal/security-policy.rst
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Security Policy
Security policy
===============

Read the Docs adheres to the following security policies and procedures with
Expand Down Expand Up @@ -73,3 +73,17 @@ Continuous integration
Incident response
Our engineering team is on a rotating on-call schedule to respond to
security or availability incidents.

Account security
----------------

* All traffic is encrypted in transit so your login is protected.
* Read the Docs stores only one-way hashes of all passwords.
Nobody at Read the Docs has access to your passwords.
* Account login is protected from brute force attacks with rate limiting.
* While most projects and docs on Read the Docs are public,
we treat your private repositories and private documentation as confidential
and Read the Docs employees may only view them
with your explicit permission in response to your support requests,
or when required for security purposes.
* You can read more about account privacy in our :doc:`/privacy-policy`.
2 changes: 1 addition & 1 deletion docs/user/privacy-policy.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.. This is linked from the footer of readthedocs.org
.. and from the version (flyout) menu on docs sites

Privacy Policy
Privacy policy
==============

Effective date: **September 30, 2019**
Expand Down
48 changes: 48 additions & 0 deletions docs/user/reference/policies.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
============================
Policies and legal documents
============================

Here is some of the fine print used by |org_brand| and |com_brand|:

.. File locations are a bit odd here because of legacy.
.. We will move files to new locations and create redirects in a later refactor

.. toctree::
:maxdepth: 1
:hidden:

/abandoned-projects
/unofficial-projects
/privacy-policy
/legal/security-policy
/security
/terms-of-service
DMCA takedown policy </dmca/index>
/legal/dpa/index

:doc:`/abandoned-projects`
Our policy of taking action on abandoned projects.

:doc:`/unofficial-projects`
Our policy of taking action on unofficial and unmaintained projects.

:doc:`/terms-of-service`
The terms of service for using |org_brand| and |com_brand|. You may instead
have a master services agreement for your subscription if you have a custom
or enterprise contract.

:doc:`/privacy-policy`
Our policy on collecting, storing, and protecting user and visitor data.

:doc:`/legal/security-policy`
Our policies around application and infrastructure security.

:doc:`/security`
How we respond to security incidents and how you report a security issue.

:doc:`/legal/dpa/index`
For GDPR and CCPA compliance, we provide a data processing addendum for
|com_brand| customers.

:doc:`/dmca/index`
Our process for taking down content based on DMCA requests and how to submit requests.
20 changes: 5 additions & 15 deletions docs/user/security.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
.. https://readthedocs.org/.well-known/security.txt
.. https://readthedocs.org/security/

Security
========
Security reports
================

Security is very important to us at Read the Docs.
We follow generally accepted industry standards to protect the personal information
Expand All @@ -16,20 +16,10 @@ we are committed to responsible reporting and disclosure of security issues.
:backlinks: none
:depth: 1

.. seealso::

Account security
----------------

* All traffic is encrypted in transit so your login is protected.
* Read the Docs stores only one-way hashes of all passwords.
Nobody at Read the Docs has access to your passwords.
* Account login is protected from brute force attacks with rate limiting.
* While most projects and docs on Read the Docs are public,
we treat your private repositories and private documentation as confidential
and Read the Docs employees may only view them
with your explicit permission in response to your support requests,
or when required for security purposes.
* You can read more about account privacy in our :doc:`privacy-policy`.
:doc:`/legal/security-policy`
Read our policy for security, which we base our security handling and reporting on.

Supported versions
------------------
Expand Down
6 changes: 3 additions & 3 deletions docs/user/unofficial-projects.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Policy for Unofficial and Unmaintained Projects
===============================================
Unofficial and unmaintained projects policy
===========================================

This policy describes a process where we take actions against unmaintained_ and unofficial_ forks of project documentation.

Expand Down Expand Up @@ -84,7 +84,7 @@ Projects that are determined to be unmaintained_ and unofficial_ will have a ``r

# robots.txt
User-agent: *
# This project is delisted according to the Policy for Unofficial and Unmaintanied Projects
# This project is delisted according to the Unofficial and Unmaintanied Project Policy
# https://docs.readthedocs.io/en/stable/unofficial-projects.html
Disallow: /

Expand Down