Closed DukeFerdinand closed 3 weeks ago
This pull request addresses two small issues encountered during implementation in a real repository. The changes are focused on the generateDocs.mjs
file, specifically modifying the process for generating the README.md file.
No diagrams generated as the changes look simple and do not need a visual representation.
Change | Details | Files |
---|---|---|
Modify README.md generation process |
|
scripts/build/generateDocs.mjs |
@DukeFerdinand Just to be super clear since I am new. This script is generating a readme for you. But at some point the readme gets updated separately from script? So then the generated data is no longer valid and overrides existing content?
@rmenner yep! the README is totally de-coupled from the repository and is retrieved from external sources. This is intended to keep all of our base README files the same across every auro repository (sans any external code that gets injected via the same build script).
TL;DR: remote README template gets pulled, cached in a directory, and filled with template + variable data when you run build:docs
:tada: This PR is included in version 2.10.0 :tada:
The release is available on:
Your semantic-release bot :package::rocket:
Alaska Airlines Pull Request
Before Submitting this pull request:
Development
section note: all pull requests require at least one linked ticketReady For Review
, all ticket's linked underDevelopment
must have their status changed toReady For Review
as wellBy submitting this Pull Request, I confirm that my contribution is made under the terms of the Apache 2.0 license and I have performed a self-review of my own update.
Fast follow on #59
Closes #59
Summary by Sourcery
Fix an issue with README.md processing by setting the overwrite flag to false and enhance the script with a warning log message to alert users about the overwrite setting.
Bug Fixes:
Enhancements: