Skip to content

[Doc]: FAQ is not reachable anymore via the main menu #26627

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

Closed
timhoffm opened this issue Aug 29, 2023 · 5 comments · Fixed by #26628
Closed

[Doc]: FAQ is not reachable anymore via the main menu #26627

timhoffm opened this issue Aug 29, 2023 · 5 comments · Fixed by #26628

Comments

@timhoffm
Copy link
Member

Documentation Link

https://matplotlib.org/devdocs/users/faq/index.html

Problem

AFAICS the only link to this page (and child pages) is in the boxes on the index page https://matplotlib.org/devdocs/.

This is hard to find.

IMHO all pages should be accessible via a chain of links starting from the main menu, because the main menu is the entry point to navigating the site.

Suggested improvement

No response

@story645
Copy link
Member

Um what do you mean by main menu in this context given that it's in the main index? Granted, still think we should do #17920 but if we must have an FAQ and it must be navigable to, then I vote for for now making it part of the user guide and having it findable from that TOC - especially if #26628 can go in.

@timhoffm
Copy link
Member Author

Um what do you mean by main menu in this context given that it's in the main index?

I want to click on a menu item here:
grafik

and on the opened page possibly 1-2 subsequent clicks on toc entries to reach the FAQ.

@story645
Copy link
Member

and on the opened page possibly 1-2 subsequent clicks on toc entries to reach the FAQ.

so #26628 should do that - it moves half the FAQ to install and the rest to the user guide & is linked to from there. Technically install is not available through that top menu either but one problem at a time. And yes it's a little buried in the user guide landing page but that's also a whole different PR/overhaul.

@jklymak
Copy link
Member

jklymak commented Aug 30, 2023

Getting Started, Install, and FAQ were all moved to the top level index in #26332. None of them is currently accessible from any links in the upper bar (except the Matplotlib logo)

@story645
Copy link
Member

Getting Started, Install, and FAQ

I think getting started should be folded back into quickstart (which is linked in userquide) & I think I'm gonna also link the install related faqs in the development install/workflow.

@story645 story645 linked a pull request Aug 31, 2023 that will close this issue
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants