Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Contributor guide review #5840

Merged
merged 13 commits into from
Dec 25, 2023

Conversation

clebergnu
Copy link
Contributor

This is part of #5757.

@mr-avocado
Copy link

mr-avocado bot commented Dec 22, 2023

Dear contributor,
Avocado is currently under sprint #103, which is due to release an LTS (Long Term Stability) release.
Please avoid merging changes that do not fall into these categories:

  • Bug fixes
  • Usability Improvements
  • Documentation updates

As for the Avocado utility modules (“avocado.utils”) it is OK to introduce new functionality,
but changes to the existing APIs (including interface and behavior) should be avoided.
These kind of changes should wait until sprint #104.

Copy link
Contributor

@richtja richtja left a comment

Choose a reason for hiding this comment

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

Hi @clebergnu, thank you for this refactoring. Overall it LGTM, I just found few typos and can you please do the rebase to #5839, thank you.

optional_plugins/spawner_remote/setup.py Outdated Show resolved Hide resolved
docs/source/guides/contributor/chapters/environment.rst Outdated Show resolved Hide resolved
docs/source/guides/contributor/chapters/styleguides.rst Outdated Show resolved Hide resolved
docs/source/guides/contributor/chapters/styleguides.rst Outdated Show resolved Hide resolved
@clebergnu
Copy link
Contributor Author

Thanks for the review @richtja, I've addressed all the issues you've found.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
It looks like readthedocs.org no longer overrides the theme when it's
building the docs.  Let's always try to se the rtd theme, unless it's
not available, that includes on readthedocs.org (where it should
always be available).

Signed-off-by: Cleber Rosa <crosa@redhat.com>
…list

Signed-off-by: Cleber Rosa <crosa@redhat.com>
Signed-off-by: Cleber Rosa <crosa@redhat.com>
Copy link
Contributor

@richtja richtja left a comment

Choose a reason for hiding this comment

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

Hi @clebergnu thank you for your updates. Unfortunately, I think I found one more typo.

docs/source/guides/contributor/chapters/environment.rst Outdated Show resolved Hide resolved
Contributing docs is not that different from other contributions, but
let's add the missing bits.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
Signed-off-by: Cleber Rosa <crosa@redhat.com>
All of the Avocado project (and pretty much every single Open Source
project) needs help.  It feels pointless to me to have this on a
couple of locations in the docs.

Let's keep track of known documentation related tasks along with all
the other known issues (GH Issues).

Signed-off-by: Cleber Rosa <crosa@redhat.com>
The information on setting up the GPG environment is outdated and
pretty much all in the "style guide" chapter.  Let's update it and
organize it better between "setting up" (environment) and using
it (style guide).

Signed-off-by: Cleber Rosa <crosa@redhat.com>
Avocado uses Black for code style enforcement, so the contributor
should really refer to it for any information on the topic.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
And while at it, let's shorten the lengths of the lines around it.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
Signed-off-by: Cleber Rosa <crosa@redhat.com>
Signed-off-by: Cleber Rosa <crosa@redhat.com>
Signed-off-by: Cleber Rosa <crosa@redhat.com>
Copy link
Contributor

@richtja richtja left a comment

Choose a reason for hiding this comment

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

LGTM, thanks.

@richtja richtja merged commit 835dd78 into avocado-framework:master Dec 25, 2023
63 checks passed
@clebergnu clebergnu deleted the contributor_guide_review branch December 28, 2023 14:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

None yet

2 participants