Skip to content

Canonical domain for books #23

@markhildreth

Description

@markhildreth

For each book, there are a variety of URLs that can be used to access some version of the book. For example, the discovery book can be "found" under the following URLs:

Since rust-embedded/wg#208, the goal has been to host them all under docs.rust-embedded.org. However, there are inconsistencies, which in some cases cause poor SEO, in others can confusion and updated content to never reach users. I have tried to find these problems that are easy to fix and list them in one place, creating and/or linking to issues to any issues that should be resolved.

Discovery Book

Canonical URL: https://docs.rust-embedded.org/discovery/
Repo: https://github.com/rust-embedded/discovery

Embedded Book

Canonical URL: https://docs.rust-embedded.org/book/
Repo: https://github.com/rust-embedded/book

Embedonomicon

Canonical URL: https://docs.rust-embedded.org/embedonomicon/
Repo: https://github.com/rust-embedded/embedonomicon

Additional Info

Currently, links using the correct domain might still use different paths, such as...

  • https://docs.rust-embedded.org/xxx
  • https://docs.rust-embedded.org/xxx/
  • https://docs.rust-embedded.org/xxx/index.html

I'm not too worried about these for now, but it might be nice to have a better canonical link system. See rust-lang/mdBook#1238 for more.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions