website hosting changes

[hx2A]

@villares @marcovicci @tabreturn

Very happy to share this with you today:

https://py5.readthedocs.io/en/latest/index.html

There are still some things that need to be straightened out before this should be shared on twitter, but they are all relatively minor compared to what I accomplished today. py5 requires a lot of customization for the readthedocs build to work correctly and it took a lot of experimentation to get right. I'll work through the other issues over the next week.

[hx2A]

OK, things are falling into place. I've fixed all of the critical readthedocs issues.

You'll notice there are two documentation versions on the website: "latest" and "dev". We can do PRs against dev to see how they look and then merge with the main branch to get them added to the "latest" version. We can have more versions (0.8.1, 0.8.2, etc), but I don't see the point in that kind of documentation granularity. We can always add that later if we feel we need it.

readthedocs has these webhooks whereby it will monitor the py5book repo and rebuild automatically when there is a PR. Neat!

There are two outstanding issues but neither is that important.

I'll issue a tweet about the new documentation website soon. I'm going to leave the existing website alone for now but will let people know it will be retired soonish. There will be a redirect or something sending visitors to the new location.

[hx2A]

Things left to do:

• add the py5-related links that are found on github to the main landing page.
• some reference docs like request_image() have links that can download resources from the new domain name.

Anything else I am missing?

[tabreturn]

Both domains/versions load fine and speedy for me --

I don't see any ads on the readthedocs pages.

I just used the built-in dev tools (but builtwith looks interesting ...)

The new py5coding domain/site appears to work perfectly :)

[tabreturn]

One small thing -- the favicon doesn't load. EDIT: I don't think there is a favicon? The _static/logo.png could work for now?

[hx2A]

One small thing -- the favicon doesn't load. EDIT: I don't think there is a favicon? The _static/logo.png could work for now?

Hmmm, I totally forgot about favicons. I believe they need to be a particular size? I'll shrink down the logo and see how it does.

[hx2A]

Hmmm, I totally forgot about favicons. I believe they need to be a particular size? I'll shrink down the logo and see how it does.

That's taken care of. Almost done preparing the website.

[hx2A]

I've deleted the readthedocs documentation website in favor of the new website, http://py5coding.org.

I believe I have successfully updated all of the links that I can change. Some of the links, like the ones on py5's pypi page, will change after the next release.

The existing http://py5.ixora.io website will stay is it is for now. After the next release I'll add a redirect to the new domain.