Server: Documentation (user and admin) missing

[wiswedel]

Steps to reproduce

1. go to "Help"
2. click on "User Documentation" (also applies to "Administrator documentation")

Expected behaviour

Documentation is shown in iFrame

Actual behaviour

Text appears:

Here goes the user documentation In the meantime go to nextcloud.com/support/

Server configuration

Nextcloud version:
15.0.2

[juliushaertl]

@MorrisJobke Maybe an issue with the build script?

[wiswedel]

It acutally seems to be hard-coded that way: server/core/doc/admin/index.html

[MorrisJobke]

Yep - since https://github.com/nextcloud/documentation/pull/956 it is not building anymore on our release system. Until now nobody complained :/ Thus also I question if the shipped documentation is the way to go.

I can have a look, but it says something quite cryptic:

unsupported theme option 'display_version' given

@skjnldsv Any idea?

[MorrisJobke]

It's in all releases after end of November.

[skjnldsv]

@MorrisJobke https://sphinx-rtd-theme.readthedocs.io/en/latest/configuring.html?highlight=display_version
This is supposed to be a valid property though.

display_version Bool. With this disabled, the version number isn’t shown at the top of the sidebar.

I guess this doesn't work. iirc we wanted to remove the But I guess we finally went with it :thinking:

[MorrisJobke]

• 
  
  
  
  • click on "User Documentation"
  
  

This is done already. Now looking into the admin manual:

Could not import extension sphinxcontrib.phpdomain (exception: cannot import name Directive)

[MorrisJobke]

Found the issue - the phpdomain that is packaged in Ubuntu 16.04 is not suited. Installed via pip solved the issue.

The next releases of Nextcloud will contain the docs again (13.0.11, 14.0.7 and 15.0.3)

[pierreozoux]

@MorrisJobke I really think the documentation there is the way to go :)
1st thanks for fixing it ;)
2nd, how is your build pipeline working, I'm trying to figure out, but can't find it, I'd like to add i18n to this logic :)

Thanks for your help!