Skip to content

Conversation

@obfischer
Copy link

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

4 participants