Skip to content

Added docs on service registration options in 17.3#7861

Merged
sofietoft merged 3 commits intomainfrom
cms/17.3-startup-options
Mar 19, 2026
Merged

Added docs on service registration options in 17.3#7861
sofietoft merged 3 commits intomainfrom
cms/17.3-startup-options

Conversation

@AndyButland
Copy link
Copy Markdown
Contributor

📋 Description

Adds details on start-up options for Umbraco, selectively registering services for the different features supported by the CMS.

📎 Related Issues (if applicable)

Relates to PR umbraco/Umbraco-CMS#21630 resolving issue umbraco/Umbraco-CMS#21622.

✅ Contributor Checklist

I've followed the Umbraco Documentation Style Guide and can confirm that:

  • Code blocks are correctly formatted.
  • Sentences are short and clear (preferably under 25 words).
  • Passive voice and first-person language (“we”, “I”) are avoided.
  • Relevant pages are linked.
  • All links work and point to the correct resources.
  • Screenshots or diagrams are included if useful.
  • Any code examples or instructions have been tested.
  • Typos, broken links, and broken images are fixed.

Product & Version (if relevant)

CMS 17.3

Deadline (if relevant)

Should be published along with the release of the RC for 17.3, which is scheduled for 19th March.

Rephrased sentences for clarity and consistency in the service registration documentation.
Copy link
Copy Markdown
Contributor

@sofietoft sofietoft left a comment

Choose a reason for hiding this comment

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

I have concerns (and ideas!) about the table under "Supported Configurations".
I agree that it makes sense to add this kinda info into a table, however, this is how the current setup looks:

Image

It's a little too condensed.
I've tried out a couple of alternatives (currently mostly leaning towards option 2):

Option 1

Image

The table has vertical scrolling, which is great, but also not so great 🤔

Option 2

Image

Separates Use Cases from the table, but the table looks cleanest in this view, if you ask me.

What do you think?

Comment thread 17/umbraco-cms/reference/service-registration.md
Co-authored-by: sofietoft <stk@umbraco.com>
@AndyButland
Copy link
Copy Markdown
Contributor Author

Option 2 looks nice to me. Just not sure about the "Learn how to..." sentence that's been added in the use case.

@sofietoft
Copy link
Copy Markdown
Contributor

Yeah, I think I mistakenly copied something from my clipboard when I went to get the screenshot 😂

Let's go for option 2 then.
I'll set it up on GitBook (just easier!) after this has been merged in a couple of weeks. Will sent you a preview before I publish the changes.

@sofietoft sofietoft merged commit ee1e5ea into main Mar 19, 2026
4 checks passed
@sofietoft sofietoft deleted the cms/17.3-startup-options branch March 19, 2026 07:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants