ð READMEçæ
ãããžã§ã¯ãåã»èª¬æã»ã€ã³ã¹ããŒã«ã³ãã³ãã»äœ¿ãæ¹ã»ã©ã€ã»ã³ã¹ãå ¥åããã ãã§ãäžè¬çãªæ§æã®README.mdé圢ãMarkdown圢åŒã§çæããããŒã«ã§ããæ°ãããªããžããªãäœæãããšãã®å©ãå°ãšããŠæŽ»çšã§ããŸãã
äœ¿ãæ¹
- ãããžã§ã¯ãåãšç°¡åãªèª¬æãå ¥åããŸãã
- ã€ã³ã¹ããŒã«ã³ãã³ããšäœ¿ãæ¹ã®ã³ãã³ããå ¥åããŸãã
- ã©ã€ã»ã³ã¹ãéžæãããšãREADME.mdã®é圢ãèªåçã«çæãããŸããã³ããŒãã¿ã³ã§ã¯ãªããããŒãã«ã³ããŒã§ããŸãã
èšç®ã®ä»çµã¿
README.mdã¯ããœãããŠã§ã¢ããããžã§ã¯ãã®æŠèŠãã€ã³ã¹ããŒã«æ¹æ³ãäœ¿ãæ¹ãªã©ã説æãããã¡ã€ã«ã§ãGitHubãªã©ã§ã¯ ãªããžããªã®ãããããŒãžã«èªåã§è¡šç€ºãããŸãããã®ããŒã«ã¯ãé ç®ãå ¥åãããšãMarkdown圢åŒã®READMEã®ã²ãªåœ¢ãäœããŸãã äœãããæ§æ ã»# ãããžã§ã¯ãåïŒèŠåºã1ïŒãšèª¬ææ ã»## Installation: ã€ã³ã¹ããŒã«ããã³ãã³ããã³ãŒããããã¯ã§è¡šç€º ã»## Usage: å®è¡ããã³ãã³ããã³ãŒããããã¯ã§è¡šç€º ã»## License:éžãã ã©ã€ã»ã³ã¹ã®èšèŒïŒããªãããéžã¶ãšçç¥ïŒ ã³ãŒããããã¯ã«ã¯ã```bashããšæžãããšã§ãGitHubãªã©ã§ã·ã§ã«ã®ã³ãã³ããšããŠè²åã衚瀺ãããŸãã
èšç®äŸ
# my-project A short description of what this project does. ## Installation ```bash npm install my-project ``` ## Usage ```bash npm start ``` ## License This project is licensed under the MIT License. èŠåºãã¯ãGitHubã§å ¬éããREADMEã§äžè¬çãªè±èªã§åºåããŸããæ¥æ¬èªã«ãããå Žåã¯ãã³ããŒããåŸã«æžãæããŠãã ããã
䜿çšäžã®æ³šæ
- READMEã«ã©ã€ã»ã³ã¹åãæžãã ãã§ã¯äžååã§ããéžãã ã©ã€ã»ã³ã¹ã®å šæã LICENSE ãã¡ã€ã«ãšããŠãªããžããªã«å ¥ããŠãã ããã
- ã¹ã¯ãªãŒã³ã·ã§ãããåäœã«å¿ èŠãªç°å¢ïŒNode.jsã®ããŒãžã§ã³ãªã©ïŒãè²¢ç®ã®æ¹æ³ãåãåããå ãªã©ãå ãããšãå©çšè ã«èŠªåã§ãã
- MITãApache-2.0ã¯èªç±åºŠãé«ããGPL-3.0ã¯æ¹å€ãããã®ãåãã©ã€ã»ã³ã¹ã§å ¬éããå¿ èŠããããªã©ãã©ã€ã»ã³ã¹ã«ãã£ãŠæ¡ä»¶ã倧ããéããŸãã
ãããã質å
çæãããREADMEããã®ãŸãŸäœ¿ããŸãã?
åºæ¬çãªæ§æã®é圢ãšããŠäœ¿ããŸãããå®éã®ãããžã§ã¯ãã«åãããŠæ©èœäžèЧãè²¢ç®æ¹æ³(Contributing)ãã¹ã¯ãªãŒã³ã·ã§ãããªã©ã®ã»ã¯ã·ã§ã³ã远å ããããšãããããããŸãã
ã©ã€ã»ã³ã¹ã®æ¬æãŸã§çæãããŸãã?
ããããã©ã€ã»ã³ã¹åãæèšããçãæç« ã®ã¿ãçæããŸããå®éã®ã©ã€ã»ã³ã¹å šæãå¿ èŠãªå Žåã¯ãéžæããã©ã€ã»ã³ã¹ã«å¿ããLICENSEãã¡ã€ã«ãå¥éãããžã§ã¯ãã«è¿œå ããŠãã ããã
è±èªã®READMEã«ãããå Žåã¯?
åå ¥åæ¬ã®å 容ãè±èªã§å ¥åããã°ããã®ãŸãŸè±èªã®READMEãšããŠçæãããŸã(èŠåºãéšåã¯çŸåšã®è¡šç€ºèšèªã«åŸããŸã)ã