The README with instructions is not being displayed in the tab "details" from your extension because vs code marketplace apparently only accepts markdown as a description.

At the user pov it would be interesting to have at least a piece of text that hints the user that there is a complete documentation in git, as at first sight this is not visible