Skip to content

libranet/minimal-github-project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 

Repository files navigation

MIT License

https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/about-community-profiles-for-public-repositories

Naming conventions

General naming conventions

  • use lowercase for filenames whenever possible. No need to SHOUT!
  • always use a proper file-extension. Not README, but readme.md.
  • Avoid polluting the root of your project-directory with file that are not required to be in the root.
  • Only keep files in the root if there are really required there.
  • .yaml is the official file-extension for YAML-files.

Naming of the Github-repository:

  • dashed lowercase, e.g. foo-bar
  • ascii, avoid non-ascii unicode chars
  • use lowercase, avoid capitals (git clone will create a similar named local directory)
  • prefer dashes over underscores

Required files to optimize Github-UI

  • license.md:
    • use license-file in the root of the project, as github will introspect this file to enhance the UI.
    • github will not follow symlinks
    • lowercase + use file-extension, e.g license.md
    • the title in the license-file should contain the name of the license, e.g. MIT
    • github will render a summarized view when viewing the license-file:

image

Right navigation in Github

image

Community Standards

Community Standards for this project: image

Security Overview

Security Overview image

Sponsor this project