Skip to content

Image registry and setup update#3233

Merged
georglauterbach merged 7 commits intomasterfrom
image-registry-and-setup-update
Apr 10, 2023
Merged

Image registry and setup update#3233
georglauterbach merged 7 commits intomasterfrom
image-registry-and-setup-update

Conversation

@georglauterbach
Copy link
Copy Markdown
Member

Description

Follow up to #3219.

Changes docker.io/mailserver for ghcr.io/docker-mailserver. Therefore updates setup.sh as well. So I figured it's okay to slightly adjust the docs for setup.sh as well.

Type of change

  • Update (non-breaking change that does improve existing functionality)
  • This change requires a documentation update

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation (README.md or the documentation under docs/)
  • If necessary I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes

@georglauterbach georglauterbach added area/scripts area/documentation meta/feature freeze On hold due to upcoming release process kind/update Update an existing feature, configuration file or the documentation labels Apr 8, 2023
@georglauterbach georglauterbach added this to the v12.1.0 milestone Apr 8, 2023
@georglauterbach georglauterbach self-assigned this Apr 8, 2023
Comment thread docs/content/config/setup.sh.md
Comment thread docs/content/config/setup.sh.md Outdated
Comment thread docs/content/config/setup.sh.md Outdated
- Remove dynamic support for showing command invoker via `${0}` for `./setup.sh` or `/usr/local/bin/setup`, just show `setup` command.
- Remove bulk of description text that isn't applicable to the `setup` command, but `./setup.sh` only.
- Revised description for help usage, as attempting `setup email help` or similar is not valid. Clarify to user they must be more specific.
- Revised the 2nd example description.
- Changed references of "script" to "CLI" which is now more accurate representation of the `setup` command.
Comment thread target/bin/setup
COMMAND ${RED}:=${RESET} { email ${RED}|${RESET} alias ${RED}|${RESET} quota ${RED}|${RESET} dovecot-master ${RED}|${RESET} config ${RED}|${RESET} relay ${RED}|${RESET} debug } SUBCOMMAND

${ORANGE}DESCRIPTION${RESET}
This is the main administration script that you use for all your interactions with
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you want to keep some of this description that was removed, you would want to relocate it to setup.sh in some manner, or the docs on setup.sh. I don't think it's relevant anymore to be interleaved into the main setup command help output.


I was not able to provide a web UI suggestion for changes and edited the file myself. The commit message detais:

  • Remove dynamic support for showing command invoker via ${0} for ./setup.sh or /usr/local/bin/setup, just show setup command.
  • Remove bulk of description text that isn't applicable to the setup command, but ./setup.sh only.
  • Revised description for help usage, as attempting setup email help or similar is not valid. Clarify to user they must be more specific.
  • Revised the 2nd example description.
  • Changed references of "script" to "CLI" which is now more accurate representation of the setup command.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note that most commands call scripts that will still output ./setup.sh in their help output.

Comment thread docs/content/config/setup.sh.md Outdated
@georglauterbach georglauterbach removed the meta/feature freeze On hold due to upcoming release process label Apr 10, 2023
@github-actions
Copy link
Copy Markdown
Contributor

Documentation preview for this PR is ready! 🎉

Built with commit: 2311aba

@georglauterbach georglauterbach merged commit 1e20e7c into master Apr 10, 2023
@georglauterbach georglauterbach deleted the image-registry-and-setup-update branch April 10, 2023 09:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/documentation area/scripts kind/update Update an existing feature, configuration file or the documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants