This commit is contained in:
Harry Moreno 2020-01-05 18:58:36 -05:00 committed by GitHub
parent fa3896dc3d
commit e58c34e9db
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -44,9 +44,9 @@ change the module's internals as long as the interface remains the same.
~ [Ken Williams, Perl Hackers](http://mathforum.org/ken/perl_modules.html#document) ~ [Ken Williams, Perl Hackers](http://mathforum.org/ken/perl_modules.html#document)
Writing READMEs is way too hard, and keeping them maintained is difficult. By offloading this process - making writing easier, making editing easier, making it clear whether or not an edit is up to spec or not - you can spend less time worry about whether or not your initial documentation is good, and spend more time writing and using code. Writing READMEs is way too hard, and keeping them maintained is difficult. By offloading this process - making writing easier, making editing easier, making it clear whether or not an edit is up to spec or not - you can spend less time worrying about whether or not your initial documentation is good, and spend more time writing and using code.
As well, standardizing can help elsewhere. By having a standard, users can spend less time searching for the information they want. They can also build tools to gather search terms from descriptions, to automatically run example code, to check licensing, and so on. By having a standard, users can spend less time searching for the information they want. They can also build tools to gather search terms from descriptions, to automatically run example code, to check licensing, and so on.
The goals for this repository are: The goals for this repository are: