source_dir attribute not working in docs

[hoe-jo]

As far as I understood the source_dir is referring to relative paths to the BUILD file and not to Bazel targets?

If I add a docs folder in a component (as defined in https://eclipse-score.github.io/score/main/contribute/general/folder.html#module-folder-structure) and set the source_dir accordingly I get following error when I trigger a docs run:

'//:score/mw/com/docs/conf.py' is invalid because 'score/mw/com' is a subpackage; perhaps you meant to put the colon here: '//score/mw/com:docs/conf.py'

[a-zw]

Yes, source_dir must be a directory but not a bazel target (hence the _dir suffix). You could try the value score/mw/com/docs.

That said, why not use docs like everybody else?

[hoe-jo]

Actually I used the value score/mw/com/docs when I tried it out.
As it is defined in the directory structure and there is a parameter for it - i figured it should work ...

[a-zw]

@AlexanderLanin does #320 address this?

[AlexanderLanin]

@AlexanderLanin does #320 address this?

No, #320 fixes the "Edit on GitHub" link when the documentation is not in "docs".

The only exception to "docs" that I'm aware of is in process_description, who for historic/unknown reasons use "process".

@hoe-jo can you link a PR where this happens?

[hoe-jo]

@AlexanderLanin Sorry I don´t have a PR right now, I wanted to set it up in the communication repo but there it did not work. So I went with the docs folder