question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

RFC: Managed Readme file

See original GitHub issue

What 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:closed
  • Created 3 years ago
  • Comments:17 (17 by maintainers)

github_iconTop GitHub Comments

1reaction
hoegertncommented, Dec 30, 2020

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.

new Readme(project, {
  toc: true,
  codeOfConduct: true,
  additionalBadges: [
    'some bagde snippet'
  ],
  ...
});

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 object

1reaction
pgolluccicommented, Dec 30, 2020

I added Roadmap and Vision below. We can definitely add install ins too. This would help a log for construct-catalog.

Read more comments on GitHub >

github_iconTop 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 >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found