Closed VictoriaAde closed 1 year ago
Congratulations on making your first Issue! :confetti_ball: If you haven't already, check out our Contributing Guidelines and Issue Reporting Guidelines to ensure that you are following our guidelines for contributing and making issues.
The left hand side menus are sufficient and must not be modified. The right hand side menus need to make the content clearer.
In this example https://docs.talawa.io/docs/features/admin-role there are four different features mentioned and it is hard to individually identify them as many of the titles are at the same level.
The left hand side menus are sufficient and must not be modified. The right hand side menus need to make the content clearer.
In this example https://docs.talawa.io/docs/features/admin-role there are four different features mentioned and it is hard to individually identify them as many of the titles are at the same level.
@palisadoes Yes, I would have done that as well in my PR for 'Consolidation of Desired Features', but I needed permission to make changes and how to change the content. If I'm given hints, I can still do it. But for that I have to know which feature need to be removed, and to decide which feature is up-to-date with Talawa? Or should I go through and study the whole website to do that?
I can do that as well if allowed. I will go though all the documentation and find relative information. And also, I'll check any typos, errors etc. And if found any ideas and suggestions for improvement, will discuss that too. And I would love to continue with Palisadoes after the contribution period ended, because it'll keep me motivated for learning. I've learned so much since March 6 that I can't imagine, so it's a source of learning and experiencing the outside world for me. I didn't imagine that learning can be so fast, easy, and excited at the same time at the competitive levels. Thank you for the opportunity @palisadoes 🙌
Thank you @palisadoes I would love to be assigned the issue.
@VictoriaAde Thank you! Please make sure to focus on the request in palisadoes comment above, regarding the indentation for the right menus. The left menus we'd like to leave alone.
@VictoriaAde Thank you! Please make sure to focus on the request in palisadoes comment above, regarding the indentation for the right menus. The left menus we'd like to leave alone.
Okay @Cioppolo14, I will focus on fixing the indentation for the right menus. Thank you.
@VictoriaAde The expectation was that the markdown files would be adjusted so that the H1, H2, H3, H4 titles would be appropriately assigned to the headings to make the table of contents usable.
We are not accepting any more changes to CSS.
@palisadoes, I have been on the code all day looking for a way to adjust the heading on the right menu without CSS. Still, unfortunately, any change I made affects the main content in the middle as that is how Docusaurus.io has been developed and the only way to make a change to the right menu is through custom CSS.
@palisadoes, I have been on the code all day looking for a way to adjust the heading on the right menu without CSS. Still, unfortunately, any change I made affects the main content in the middle as that is how Docusaurus.io has been developed and the only way to make a change to the right menu is through custom CSS.
You'll have to make changes to headings, open the markdown files and change the h2 into h3 you'll see the difference on right side menu
@palisadoes, I have been on the code all day looking for a way to adjust the heading on the right menu without CSS. Still, unfortunately, any change I made affects the main content in the middle as that is how Docusaurus.io has been developed and the only way to make a change to the right menu is through custom CSS.
You'll have to make changes to headings, open the markdown files and change the h2 into h3 you'll see the difference on right side menu
@salman-farooqi I have done that, it was my first approach but there was no change to the right-side menu. I went on the Docusaurus.io official Docs and they recommended the custom CSS approach.
Well as far as I understood the issue, it has to be markdown changes only
I've checked your PR, you just increased the h1 sizes using CSS. On the contrary, you should decrease the size of other headings in markdowns except h1 and see how it works.
There must be no changes to the CSS. The problem can be solved without doing so by editing the original markdown file
So @palisadoes I think the reason why editing the original markdown file won't work is that the side menu is originally in<ul> <li> <a>
tags, so it's not markdown.
You can try inspecting to get what I mean, the class names for the markdown are different from that of the side menu to tell you that it's not markdown.
It will work because docusaurus converts markdown to HTML. Please research docusaurus and how it does this. All the documentation on the docs.talawa.io site is sourced from markdown file in the docs/
directory.
Okay @palisadoes, I will do more research on it and get back to you soon.
@palisadoes I have seen how the markdown can be used to improve the right sidebar, however, for the Admin Capabilities page I need to know which features need to be removed, and to decide which feature is up-to-date based on the comment made here Comment
Please fix the headings. We'll work on updating the content later. We'll need the updates to be done to all the pages under features too.
Okay, I am on it.
Describe the bug Talawa-Docs: the pages under Requirements Docs/Desired features were recently consolidated and this has resulted in the pages not having the correct title indentations. As the menu on the left does not change nor show the user that they are scrolling.
To Reproduce Go to this URL and scroll, notice that it is hard to identify which feature you are on from the table of contents on the left-hand menu
Screenshots