Skip to content

Automate process of building docs for docs.rust-embedded.org #457

@markhildreth

Description

@markhildreth

When accessing any of the three books from the docs.rust-embedded.org domain, the version of the documents received are over two months out of date, dating back to March 15th.

> date
Fri May 29 15:40:13 EDT 2020
> curl -s --head "https://rust-embedded.github.io/discovery/" | grep last-modified
last-modified: Thu, 28 May 2020 02:46:55 GMT
> curl -s --head "https://docs.rust-embedded.org/discovery/" | grep last-modified
last-modified: Sun, 15 Mar 2020 19:52:23 GMT
> curl -s --head "https://rust-embedded.github.io/book/" | grep last-modified
last-modified: Fri, 29 May 2020 17:35:25 GMT
> curl -s --head "https://docs.rust-embedded.org/book/" | grep last-modified
last-modified: Sun, 15 Mar 2020 19:52:23 GMT
> curl -s --head "https://rust-embedded.github.io/embedonomicon/" | grep last-modified
last-modified: Tue, 21 Apr 2020 17:28:25 GMT
> curl -s --head "https://docs.rust-embedded.org/embedonomicon/" | grep last-modified
last-modified: Sun, 15 Mar 2020 19:52:23 GMT

Additionally, the bookshelf is also out of date:

> curl -s --head "https://docs.rust-embedded.org" | grep last-modified
last-modified: Sun, 15 Mar 2020 19:52:23 GMT

This is because the docs.rust-embedded.org domain looks specifically to the /docs repository, which uses submodules to pull in the other book repositories. Unfortunately, there doesn't appear to be any automated system (or if there is, it is not working) to rebuild the gh-pages branch in the /docs repo enough to keep them up to date.

Activity

adamgreig

adamgreig commented on May 29, 2020

@adamgreig
Member

I believe that's because those are all generated/hosted via https://github.com/rust-embedded/docs/tree/gh-pages which has each book as a submodule. Not necessarily a great system...

markhildreth

markhildreth commented on May 29, 2020

@markhildreth
Author

@adamgreig Ah, thanks, didn't realize they were all in that repo. Is there a system in place that should be automating this that isn't working, or is there no such automatic system in place yet?

adamgreig

adamgreig commented on May 29, 2020

@adamgreig
Member

I'm not sure actually. I don't see anything that would cause a regular build to run, but such things are possible to have on Travis.

changed the title [-]Books are months out of date when accessed from docs.rust-embedded.org[/-] [+]Automate process of building docs for docs.rust-embedded.org[/+] on May 29, 2020
added a commit that references this issue on Jul 4, 2020
9ad8d55
yerke

yerke commented on Jul 4, 2020

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Development

      No branches or pull requests

        Participants

        @adamgreig@markhildreth@yerke

        Issue actions

          Automate process of building docs for docs.rust-embedded.org · Issue #457 · rust-embedded/wg