Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add an option to use a custom path for README.md using terraform_docs #132

Closed
achaussier opened this issue Aug 3, 2020 · 5 comments · Fixed by #245
Closed

Add an option to use a custom path for README.md using terraform_docs #132

achaussier opened this issue Aug 3, 2020 · 5 comments · Fixed by #245
Labels
estimate/1day Need 1 work day to be done feature New feature or request hook/terraform_docs Bash hook stale Denotes an issue or PR has remained open with no activity and has become stale.

Comments

@achaussier
Copy link

Hello,

First, thanks for this useful project !

Can it be possible to add a custom path for README.md when using terraform_docs hook ?

This use case can appears when Terraform files are in a subfolder, but the repository only host a single module, ex:

.
├── .gitignore
├── .gitlab-ci.yml
├── .pre-commit-config.yaml
├── README.md
└── src
    ├── main.tf
    ├── outputs.tf
    └── variables.tf

My different tries tends to use a dedicated README.md in the .tf files folder and reference it using a link inside the top level README.md file, but I foud the result less readable.

Thanks

@uridium
Copy link

uridium commented Jan 15, 2021

Same here.
That is especially needed if you use Terraform Cloud and select "Only trigger runs when files in specified paths change".

@MaxymVlasov
Copy link
Collaborator

Hi @achaussier, @uridium
You can just create a symlink like ln -s src/README.md README.md in the repo root.

And I think is not a very good idea do not to have module README at the same level as the module.
The root README can have some docs like "how to contribute" and so on, when module README should contain details only related to the module.

@MaxymVlasov MaxymVlasov added hook/terraform_docs Bash hook feature New feature or request labels Sep 3, 2021
@MaxymVlasov
Copy link
Collaborator

Relates to #7

@MaxymVlasov MaxymVlasov added the estimate/1day Need 1 work day to be done label Sep 3, 2021
@github-actions
Copy link

github-actions bot commented Oct 4, 2021

This issue has been automatically marked as stale because it has been open 30 days
with no activity. Remove stale label or comment or this issue will be closed in 10 days

@github-actions github-actions bot added the stale Denotes an issue or PR has remained open with no activity and has become stale. label Oct 4, 2021
@github-actions
Copy link

This issue was automatically closed because of stale in 10 days

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
estimate/1day Need 1 work day to be done feature New feature or request hook/terraform_docs Bash hook stale Denotes an issue or PR has remained open with no activity and has become stale.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants