Initial docs #40
Initial docs #40
Conversation
Why is the docname relevant for the id? If things are placed in their module repo, there is no need to mention the feature in filenames.
a-zw
requested review from
LittleHuba,
castler,
hoe-jo,
nradakovic and
ramceb
as code owners
nradakovic
left a comment
nradakovic
left a comment
There was a problem hiding this comment.
I'm reviewed PR from Build&CI side. The owner of baselibs will leave final comments on other changes.
| build:bl-x86_64-qnx --extra_toolchains=@toolchains_qnx_qcc//:qcc_x86_64 | ||
| test:bl-x86_64-qnx --config=bl_common | ||
|
|
||
| build --java_language_version=17 |
There was a problem hiding this comment.
Default build settings won't be hardcoded to one version. If you want to use JAVA 17 please provide proper configuration settings for it.
There was a problem hiding this comment.
My understanding is that Bazel requires us to hardcode it like this. We just want to use plantuml in our documentation.
Do you know any better solution?
|
@a-zw why are you starting this here? |
|
my latest info is that baselibs wants to use TRLC and not sphinx-needs. So I guess we need to put only a basic structure here, without moving needs into this repository. |
|
@a-zw, Thank you for submitting this PR. Unfortunately, we've also been working on integrating docs-as-code and are close to pushing the changes. Our plan is to migrate the sphinx-needs documentation from the score repository while preserving the git history, rather than simply copying files. We don't currently plan to use TLRC in this repository. Would you be interested in joining our weekly meeting on Wednesday? I'll prepare several gh issues beforehand that we can distribute among contributors. It's to avoid duplicate work. |
|
Closing this as @rahulthakre29 will do it from internally. |
5 participants
So far, baselibs have no documentation in their repository, but it is stored in the score platform repo. It shall move here now that docs-as-code properly supports cross-repo linking.
This is a first PR just to introduce docs-as-code to this repo. Fixes #41