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

Clarify documentation of config sub-directory from which external application properties are read #32224

Conversation

obfischer
Copy link
Contributor

The current documentation relates to the subdirectory for external configurations as /config. Read as UNIX path, the leading slash could be read as reference to the root directory /. Therefore I would suggest to use ./config to make it a little bit more understandable.
This is of course not a major issue, but IMHO makes it a little bit more understandable.

@spring-projects-issues spring-projects-issues added the status: waiting-for-triage An issue we've not yet triaged label Sep 3, 2022
@wilkinsona wilkinsona changed the title Make the path of the config directory better understandable Clarify documentation of config sub-directory from which external application properties are read Sep 5, 2022
@wilkinsona
Copy link
Member

Thanks for spotting this, @obfischer, and raising a PR. I agree that /config is misleading. As a replacement, I wonder if config/ would be better than ./config. The trailing slash is commonly used to indicate that a path is a directory (and it's what both bash and zsh tab-complete to).

@wilkinsona wilkinsona added type: documentation A documentation update and removed status: waiting-for-triage An issue we've not yet triaged labels Sep 5, 2022
@wilkinsona wilkinsona added this to the 2.6.x milestone Sep 5, 2022
@wilkinsona wilkinsona added the status: waiting-for-feedback We need additional information before we can continue label Sep 5, 2022
@snicoll
Copy link
Member

snicoll commented Sep 9, 2022

@obfischer any opinion about this? If you agree, we can also polish this as part of merging but we'd like to make sure the updated proposal addresses your concern.

@obfischer obfischer force-pushed the improvement/clearify-path-of-config-directory branch from 1b3245f to 2863c4e Compare September 9, 2022 23:40
@obfischer
Copy link
Contributor Author

I think @wilkinsona has a good point. I updated my pull request.

The current documentation relates to the subdirectory for external
configurations as `/config`. Read as UNIX path, the leading slash
could be read as reference to the root directory `/`. Therefore
I would suggest to use `./config` to make it a little bit more
understandable.
This is of course not a major issue, but IMHO makes it a little
bit more understandable.
@obfischer obfischer force-pushed the improvement/clearify-path-of-config-directory branch from 2863c4e to bbf4950 Compare September 9, 2022 23:42
@spring-projects-issues spring-projects-issues added status: feedback-provided Feedback has been provided and removed status: waiting-for-feedback We need additional information before we can continue labels Sep 9, 2022
@snicoll snicoll self-assigned this Sep 10, 2022
@snicoll snicoll removed the status: feedback-provided Feedback has been provided label Sep 10, 2022
@snicoll snicoll modified the milestones: 2.6.x, 2.6.12 Sep 10, 2022
snicoll pushed a commit that referenced this pull request Sep 10, 2022
Currently, the documentation relates to the subdirectory for external
configurations as `/config`. Read as UNIX path, the leading slash
could be read as reference to the root directory `/`.

This commit updates the documentation to use 'config/' instead.

See gh-32224
@snicoll snicoll closed this in 42db66c Sep 10, 2022
@snicoll
Copy link
Member

snicoll commented Sep 10, 2022

Thanks for the follow up and the contribution @obfischer

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type: documentation A documentation update
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants