readthedocs.org
c2849d39 - Add an initial policy for delisting unmaintained projects (#9731)

Commit
3 years ago
Add an initial policy for delisting unmaintained projects (#9731) * Add an initial policy for delisting unmaintained projects I'm not 100% in love with this content structure, but I think it's important to get this out. Closes https://github.com/readthedocs/readthedocs.org/issues/9130 * Move legalise to the bottom * A bit more clarify * Add to TOC * Apply the most immediately uncomplicated suggestions from code review Co-authored-by: Manuel Kaufmann <humitos@gmail.com> Co-authored-by: Anthony <aj@ohess.org> * Expand section on what "unmaintained" means * Add more cross-references for defined terms * sembr * Adding linebreaks * Remove "candidate" and make it a bit more clear that someone needs to submit a report * Add a template for emails * Move definitions to "specification" as @humitos suggested * Move use cases to "Examples" under rationale * Adds robots.txt boilerplate * Add a step that the source project is notified by RTD core team * resolve warning - include in TOC * Add a comment in robots.txt template * Update docs/user/unofficial-projects.rst * Adds a link in robots.txt to where the policy will presumably live * Apply suggestions from @agjohnson code review Co-authored-by: Anthony <aj@ohess.org> * Update docs/user/unofficial-projects.rst Co-authored-by: Eric Holscher <25510+ericholscher@users.noreply.github.com> * Remove procedure to notify upstream maintainers * Change Specification to Definitions * Move High-level Overview to Rationale * Add a definition of source project * Delisting with notification. Step added to take no further action if unreachable. Step added that actions may be taken if reachable * Talk mostly of "owner" in plural, there might be several people maintaining a documentation project * Remove SOME stuff, we aren't going to seriously validate that * Remove examples section, it doesn't fill much purpose now * Apply suggestions from @humitos and @erichholscher Co-authored-by: Manuel Kaufmann <humitos@gmail.com> Co-authored-by: Eric Holscher <25510+ericholscher@users.noreply.github.com> * reference Terms of Service doc * Move delisting section * Remove step outlining what happens if "unreachable" since nothing happens * Remove definition of "Unreachable" since it's not in use * Remove definition of Source Project * Update docs/user/unofficial-projects.rst Co-authored-by: Eric Holscher <25510+ericholscher@users.noreply.github.com> * Add cross-references to Project Policies * Apply suggestions from code review Co-authored-by: Manuel Kaufmann <humitos@gmail.com> * Update docs/user/abandoned-projects.rst Co-authored-by: Manuel Kaufmann <humitos@gmail.com> * Update docs/user/abandoned-projects.rst Co-authored-by: Manuel Kaufmann <humitos@gmail.com> * ANY and ALL => **any** or **all** Co-authored-by: Benjamin Balder Bach <benjamin@readthedocs.org> Co-authored-by: Manuel Kaufmann <humitos@gmail.com> Co-authored-by: Anthony <aj@ohess.org> Co-authored-by: Benjamin Bach <benjamin@overtag.dk>
Author
Parents
Loading