Skip to content
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

Enhance Repository and Org Visibility on GitHub #32

Open
3 of 6 tasks
tajmone opened this issue May 1, 2021 · 1 comment
Open
3 of 6 tasks

Enhance Repository and Org Visibility on GitHub #32

tajmone opened this issue May 1, 2021 · 1 comment
Labels
enhancement New feature or request

Comments

@tajmone
Copy link
Contributor

tajmone commented May 1, 2021

To enhance the repository visibility:

Repository Details

Edit About box setting (repository details):

  • Website field, add: https://www.pml-lang.dev
  • Topics field, add: pml practical-markup-language html-converter (etc.)
  • Include in the homepage field, remove "Package" (if not needed).

GitHub topics are a powerful feature, they don't just simplifying find repositories on GitHub: by adding PML keywords to the topics you're actually promoting PML's visibility on GitHub, and once a keyword reaches a certain numbers of repository that are using it you automatically obtain visibility on various GitHub services and sub-pages.

Media Preview Card

  • Add repository media preview.

In Settings » Options: "Social preview" you can add a social media preview card for the PML repository, which will be showed whenever the repository is linked in websites, blogs and forums that support media cards. You'll also find a link to a graphic template there, to build your card with.

You can use the SocialSharePreview.com or Twitter Card Validator
services to check how your card looks like. E.g., here's the link to the media preview card of Sublime-PML; and here's a screenshot from Twitter:

Sublime-PML-social-card-preview

If you need any help with the graphics, just buzz me via PM. I work a lot of graphics.

Add pml-lang Profile README

To enhance the landing page of the pml-lang GitHub profile, add a profile README:

  • Create new repository: pml-lang/pml-lang
    • Add README.md (or .asciidoc, etc.) with a brief presentation of PML (not 100% sure, but I think you can include images in the repository too).

Needless to say, the same tips apply to any other repository and to the pxml-lang as well.

@pml-lang
Copy link
Owner

pml-lang commented May 3, 2021

Great suggestions!
Thank you.

@pml-lang pml-lang added the enhancement New feature or request label May 3, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants