Meshery: [Docs] Fix missing documentation, logo path, Images and Table of Content

[JubayerJoy]

Current State:

• Documentation missing in https://meshery.layer5.io/docs/installation/platforms/windows
• The logos are broken in https://meshery.layer5.io/docs/installation/platforms
• Images are not shown in https://meshery.layer5.io/docs/guides/interpreting-performance-test-results
• Sections in the table of contents are repeated twice on,
  
  
  
  • https://meshery.layer5.io/docs/guides
  
  
  • https://meshery.layer5.io/docs/functionality
  
  

Desired State:

• [x] Windows documentation should be added as soon as possible.
• [x] Logos should appear correctly.
• [x] Images should appear correctly.
• [x] Table of contents should be fixed in,
  
  
  
  • https://meshery.layer5.io/docs/guides
  
  
  • https://meshery.layer5.io/docs/functionality
  
  

---

Contributor Resources

• Meshery documentation site
• Meshery documentation source
• Instructions for contributing to documentation

[welcome[bot]]

Thanks for opening this issue. A contributor will be by to give feedback soon. In the meantime, please review the Layer5 Contributors' Welcome Guide and sure to join the community Slack.

[leecalcote]

@JubayerJoy thanks for this. Have a look at https://github.com/layer5io/meshery/pulls/1388

[JubayerJoy]

@leecalcote, I have reviewed the PR. Some great work by @PluckyPrecious 🚀
That PR fixes image issue.

I think windows documentation, broken logo, and ToC is not yet covered 😕
@PluckyPrecious, what is your thought about this?

[PluckyPrecious]

Hi @JubayerJoy it is great if you can cover those as i'm on transit and will be off my system for now. @leecalcote what you say?

[chandrashritii]

@JubayerJoy Thanks for pointing these out. I'll take this one on if you haven't started working on it already.

[JubayerJoy]

@chandrashritii sure, I haven't started, go-ahead 👍

[kishore007k]

Is this issue still open? If so, I'll take this on.

[chandrashritii]

@kishore007k I'm working on this one at the moment. Let's find you another issue :)

[kishore007k]

@chandrashritii 👍🤞

[KarenEfereyan]

Is this issue still open?

[sbs2001]

https://meshery.layer5.io/docs/architecture is missing the images.

[JubayerJoy]

Hi @sbs2001, good catch!
A common practice is to open a new issue if you can't find the same issue listed or mentioned anywhere.
If you want you can create a new issue or I can open one for you if you want.

Cheers!

[sbs2001]

@JubayerJoy

If you want you can create a new issue or I can open one for you if you want.

No thanks !

A common practice is to open a new issue if you can't find the same issue listed or mentioned anywhere.

FWIW this ticket is labeled duplicate for some reason, add to that my issue is a subset of what you are proposing(atleast the title). So IMHO opening a new issue is not necessary.

[JubayerJoy]

@sbs2001

FWIW this ticket is labeled duplicate for some reason, add to that my issue is a subset of what you are proposing(atleast the title).

True, your issue is a subset of the issues mentioned in the title. It's labeled duplicate cause some of them are already covered by other tickets (You can see some of them are already fixed).

So IMHO opening a new issue is not necessary.

My point is, I am not updating this list with similar issues, so the issue you mentioned might go unnoticed.
Each time an image breaks or document is missing, it falls under this title. Should people comment again and again here to get the issue noticed?
So, why not open a new issue?

[chandrashritii]

@JubayerJoy Thank you for pointing out the documentation mistakes.
The issue with the missing links in the architecture page have been captured in #1675.
The windows page has been updated in PR #1657
The installation guides have been fixed in #1673

Other issues mentioned in the description have also been duly fixed through past PR's by other contributors. New issues should be opened to point out any future documentation errors.

[chandrashritii]

//CC @leecalcote Closing this issue.