Skip to content

Conversation

@kesselb
Copy link
Collaborator

@kesselb kesselb commented Oct 21, 2025

Summary

Error when building the docs:

reading sources... [100%] configuration_server/config_sample_php_parameters
/home/daniel/Code/nextcloud-docs/admin_manual/configuration_server/config_sample_php_parameters.rst:3644: ERROR: Unexpected indentation. [docutils]
/home/daniel/Code/nextcloud-docs/admin_manual/configuration_server/config_sample_php_parameters.rst:3890: ERROR: Unexpected indentation. [docutils]

Caused by:

Allow creation of external storages of type "Local" via the web interface and
APIs. When disabled, local storages can still be created using the occ command::
  occ files_external:create /mountpoint local null::null -c datadir=/path/to/data

(c.f. https://github.com/nextcloud/documentation/blob/978e27d3a47239fff6d35157770461986f046fdf/admin_manual/configuration_server/config_sample_php_parameters.rst?plain=1#L3642-L3644)

I'd also think the command is nicer as a block and easier to copy, however is it's currently causing an issue and there are also of couple of other occ references in that file using the other syntax.

Checklist

@kesselb kesselb self-assigned this Oct 21, 2025
@kesselb kesselb requested a review from a team as a code owner October 21, 2025 14:56
@kesselb kesselb requested review from Altahrim, ArtificialOwl and sorbaugh and removed request for a team October 21, 2025 14:56
@kesselb kesselb added the 3. to review Waiting for reviews label Oct 21, 2025
@kesselb kesselb force-pushed the chore/sample-config-convert-issue branch from 9b7fa6d to 6144f10 Compare October 22, 2025 15:45
@kesselb kesselb force-pushed the chore/sample-config-convert-issue branch from 6144f10 to 1853165 Compare October 22, 2025 16:22
@nickvergessen
Copy link
Member

Okay, the actual problem is when there code block is at the start of the description (first line is considered summary of the description).

both is crying for problems at some point

@nickvergessen nickvergessen merged commit f236c0a into master Oct 23, 2025
182 of 185 checks passed
@nickvergessen nickvergessen deleted the chore/sample-config-convert-issue branch October 23, 2025 13:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3. to review Waiting for reviews

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants