Skip to content

Support ReadtheDocs #105

Closed
Closed

Description

@kelle

Based on discussion in #39, there is a concensus that we want to be supporting ReadtheDocs. I'm starting a new thread specifically for that action item.

Since NumFocus takes care of our Slack and Zoom costs, I am in discussions with them to see if we want to communicate with RTD as "Astropy" or as part of a larger contribution from NumFocus which could benefit more projects. I will update as we work this out.

Activity

  1. kelle commented on Jun 5, 2020

    @kelle
    MemberAuthor

    We're gonna move forward with contributing as Astropy. I'll get in touch with RTD directly to figure out the arrangement that makes the most sense for us.

  2. pllim commented on Jun 5, 2020

    @pllim
    Member

    Please tell them that we really want to use their PR builder feature for astropy. My previous request for that was rejected because astropy is "too big and too active" but hopefully that is not a problem if we are a paying customer? Thanks!

  3. bsipocz commented on Jun 5, 2020

    @bsipocz
    Member

    there is also a short list of feature we would very much like for a very long time now, let's see maybe they are open to those being "paid for".
    (the most important is the disabling the github edit links that redirects to the stable branch. it shouldn't take time much for someone familiar with their JS)

  4. kelle commented on Jun 5, 2020

    @kelle
    MemberAuthor
  5. pllim commented on Jun 5, 2020

    @pllim
    Member

    Can't think of anything else for now. I think the issue that @bsipocz mentioned above is readthedocs/readthedocs.org#6297 (please correct me if I am wrong).

  6. bsipocz commented on Jun 5, 2020

    @bsipocz
    Member

    Yes, that's the issue. The other one I had in mind seems to be resolved very recently (being able to hide versions from dropdown, while they are still available with direct links).

    Another one, that I cannot find an issue for is the ability to disable indexing of old versions (we manually worked around that issue as were not able to add the robots files, but it's not a final, good solution). I suspect adding these custom configs on the project level might be a more significant feature request.

  7. bsipocz commented on Jun 5, 2020

    @bsipocz
    Member

    (but as @pllim said, the most important would be to be able to trigger builds from PRs)

  8. Cadair commented on Jun 8, 2020

    @Cadair
    Member

    (As an aside, please do let me know how the discussions with RTD go and what kind of arrangement you end up with to enable PR builds etc, I would be potentially interested in replicating it for sunpy.)

  9. kelle commented on Jun 12, 2020

    @kelle
    MemberAuthor

    email sent and cc'd @bsipocz and @pllim.

  10. kelle commented on Jun 26, 2020

    @kelle
    MemberAuthor

    Finance committee approved support at the $600/year level. And Kelle used the PEX card to upgrade the astropy membership.

  11. kelle commented on Jun 26, 2020

    @kelle
    MemberAuthor

    At our level, we can only make 10 projects ad-free. Which of the following 13 should be made ad-free?
    Screen Shot 2020-06-26 at 11 41 45 AM

  12. reopened this on Jun 26, 2020
  13. bsipocz commented on Jun 26, 2020

    @bsipocz
    Member

    core and coordinated packages. Many of which is not on the list, but they should be.

    That leaves two more slots, I would go for the template, and pyvo as for the latter the plan was to make it coordinated sometimes late last year.

  14. astrofrog commented on Jun 28, 2020

    @astrofrog
    Member

    Agree with @bsipocz that we should do core package + the 7 coordinated packages - we need to add astropy as a maintainer on all coordinated packages for them to all show up.

  15. kelle commented on Jul 3, 2020

    @kelle
    MemberAuthor

    Do y'all need me to do anything else with this? Not sure who is can add astropy as a maintainer on the coordinated packages. Should we send an email to the maintainer's list with instructions?

  16. pllim commented on Jul 6, 2020

    @pllim
    Member

    FWIW -- As far as this issue is concerned, I think it can be closed when #105 (comment) is resolved. As for enabling it for those repos, they can be tracked as separate issues for the affected repos.

  17. kelle commented on Mar 22, 2022

    @kelle
    MemberAuthor

    This is the content of the email response from rtd. (As far as I can tell, we never got back to them about the github edit links.)

    Firstly, thanks for your interest in supporting us. We're truly grateful.

    • access to the PR build feature

    This feature looks like it's enabled for you already -- at least for your base project. We are slowly enabling this for more and more projects as we roll it out more widely and if there are additional projects that need it, don't hesitate to let us know.

    • disable the github edit links that redirects to the stable branch.

    I did have a question about this. I attached a quick screenshot and I just wanted to clarify that these were the links you were trying to remove. Is that correct?

    • disable indexing of old versions

    You can control this yourself! Simply choose the versions you want to be "active" on this page. Updating the active versions will automatically update a generated sitemap file and inform search engines which version should be indexed.

    Could you please let us know if those requests are feasible and what level of monthly support you think would be appropriate for us?

    Our recommended levels of support is $50 for company- or grant-backed projects. If that works, we really appreciate it.

  18. pllim commented on Mar 23, 2022

    @pllim
    Member

    xref #248

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions