RFC: Managed Readme file
See original GitHub issueWhat do you think about introducing a construct for a README.md
.
Not the existing SampleFIle but a projen managed one.
Many projects could benefit from some opinionated defaults.
I think of a list of badges that are auto-generated, installation instructions depending on project type, license info, link to CHANGELOG.md
and API.md
, etc.
The main part would still be custom text that the repo owner has to provide.
Issue Analytics
- State:
- Created 3 years ago
- Comments:17 (17 by maintainers)
Top Results From Across the Web
rfcs/README.md at master · vuejs/rfcs - GitHub
The "RFC" (request for comments) process is intended to provide a consistent and controlled path for new features to enter the framework.
Read more >rfc8874.txt - » RFC Editor
Issue tracking can be used to manage open issues and provide a record of ... Updating the README or CONTRIBUTING file in the...
Read more >Working Group GitHub Usage Guidance RFC 8874
Repositories MUST include a copy of or reference to the policy that applies to managing any documents they contain. Updating the README or...
Read more >Frequently Asked Questions - Time Machine Europe
For more information, please refer to the Readme file in the RFC repository. With financial support. With financial support.
Read more >Oracle Access Management Bundle Patch Readme
Readme. This document describes OAM Bundle Patch 12.2.1.4.200629. This document requires a base installation of Oracle Access Management 12c Patch.
Read more >
Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free
Top Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
I am thinking about not putting the README into the project options (there are soo many) but have a ReadmeConstruct that gets initialized with a project and its own props.
Additionally:
project.addReadme(props);
A lot of the content could be automagically be derived.
EDIT: OTOH maybe only
readme: true
and then configure the rest on a readme objectI added Roadmap and Vision below. We can definitely add install ins too. This would help a log for construct-catalog.