Skip to content

Move installing FAQ to installing page. #20917

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

Merged
merged 1 commit into from
Aug 27, 2021

Conversation

timhoffm
Copy link
Member

People with install problems will primarily look at the install page,
not the general FAQ page.

Question: Should we move the page in the file structure as well?
Con: External pages linking the FAQ will be broken. I wouldn't worry
too much about this. Who links install FAQs anyway? And I trust
that even with a broken Link people will look at Installing.
Pro: The file structure corresponds to the toc structure.

People with install problems will primarily look at the install page,
not the general FAQ page.

Question: Should we move the page in the file structure as well?
Con: External pages linking the FAQ will be broken. I wouldn't worry
     too much about this. Who links install FAQs anyway? And I trust
     that even with a broken Link people will look at Installing.
Pro: The file structure corresponds to the toc structure.
@timhoffm timhoffm added this to the v3.5.0 milestone Aug 26, 2021
@rishawsingh
Copy link

hi @timhoffm can I work on it?

@timhoffm
Copy link
Member Author

@rishawsingh Thanks for your interest in contributing. This is a pull request, i.e. the work is already done in here. There's nothing more to do other than approve, which has to be done by a core contributor.

You are welcome to pick another issue. Check the "good first issue" tag.

Copy link
Member

@story645 story645 left a comment

Choose a reason for hiding this comment

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

since this is structural, does it need two approvals to merge?

@jklymak
Copy link
Member

jklymak commented Aug 27, 2021

I would argue not, unless there is reason for controversy, or by structural you mean a large reorg. Changing documentation doesn't break anyone and we can always revert if someone strongly objects.

@timhoffm timhoffm merged commit 1a363bc into matplotlib:master Aug 27, 2021
@timhoffm timhoffm deleted the doc-installing-faq branch August 27, 2021 20:46
meeseeksmachine pushed a commit to meeseeksmachine/matplotlib that referenced this pull request Aug 27, 2021
QuLogic added a commit that referenced this pull request Aug 27, 2021
…917-on-v3.5.x

Backport PR #20917 on branch v3.5.x (Move installing FAQ to installing page.)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants