Skip to content
This repository has been archived by the owner on Sep 8, 2024. It is now read-only.

Fix readthedocs build #2749

Merged
merged 4 commits into from
Nov 9, 2020
Merged

Fix readthedocs build #2749

merged 4 commits into from
Nov 9, 2020

Conversation

forslund
Copy link
Collaborator

@forslund forslund commented Nov 6, 2020

Description

After readthedocs was fixed enough to update again a couple of issues were observed, the most obvious one that the docs for MycroftSkill derived classes are missing. See here

This was due to xdg not being mocked when generating the docs, and thus erroring out when sphinx imported those modules. This adds xdg as a autodoc_mocked_import.

Finding this out I realized the same isse ẃas causing the previous issue with yaml so that has been cleaned up as well.

I also noticed that the .readthedocs file was not named correctly and wasn't actually used. This renames it and fixes an incorrect path making it usable.

How to test

I generated readthedocs from this branch here Make sure the MycroftSkills module and related modules are generated properly.

Contributor license agreement signed?

CLA [ Yes ]

- Rename it to .readthedocs.yml
- Fix doc requirements path
Tries to make it clearer when module name needs to be inserted manually.
@forslund forslund added the Type: Bug - quick Bug fixes that are quick to review and the implications of the change are clear and contained. label Nov 6, 2020
@devs-mycroft devs-mycroft added the CLA: Yes Contributor License Agreement exists (see https://github.com/MycroftAI/contributors) label Nov 6, 2020
@devops-mycroft
Copy link

Voight Kampff Integration Test Succeeded (Results)

Copy link
Contributor

@krisgesling krisgesling left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You're awesome, thanks!

@krisgesling krisgesling merged commit b3675f1 into dev Nov 9, 2020
@krisgesling krisgesling deleted the bugfix/readthedocs branch November 9, 2020 05:22
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
CLA: Yes Contributor License Agreement exists (see https://github.com/MycroftAI/contributors) Type: Bug - quick Bug fixes that are quick to review and the implications of the change are clear and contained.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants