astropy / astropy/astropy.github.com

Migrate astropy.org to be hosted RTD

Open
#697 12 comments 1 reaction 0 assignees View on GitHub
Feature Request
Dominant language
Python
Stars
47
Forks
107
Avg merge
1d 6h
Merged PRs (30d)
5

Description

This is a early warning / heads up issue.

As part of my Cycle 5 proposal to improve the unification of the astropy docs (https://github.com/astropy/astropy-project/blob/b04f81d10e268f700b4d6b9fe1fac5811daf155b/finance/proposal-calls/cycle5/aperio-documentation.md) it would be helpful to migrate astropy.org to be hosted on RTD.

The main motivation for this is that it allows the site to be indexed by the RTD server side search and to access that API without any tickery. This allows the unified search to work across the various projects *and* the homepage.

(It should also be noted that I'm in the process of migrating the site to be built with sphinx to enable all this as well)

Contributor guide

Open the contributing guide

Research direction

Read the Cycle 5 proposal at finance/proposal-calls/cycle5/aperio-documentation.md and inspect the current astropy.org build while the Sphinx migration is in progress. Define the hosting and migration scope, then verify that the site is hosted on RTD and available to the unified search through the RTD search API.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.