Krita Documentation as Git Submodule?

Halla Rempt boud at valdyas.org
Sun Jul 11 10:27:49 BST 2021


I don't really have an opinion, I'm afraid. We could give it a try... 
On Thursday, 8 July 2021 07:40:33 CEST Emmet O'Neill wrote:
> Hey all,
> 
> I'm wondering what you all think of the idea of linking Krita's
> documentation to the source repository as a [git submodule.](
> https://git-scm.com/docs/git-submodule)
> 
> I'm thinking something along the lines of `git submodule add
> git at invent.kde.org:documentation/docs-krita-org.git docs/` to create a
> submodule at `source/docs/`.
> We can then suggest new devs run `git clone --recurse-submodules
> https://invent.kde.org/graphics/krita.git` to pull both the source code and
> docs at the same time.
> (Existing copies would run `git pull --recurve-submodules` or `git pull`
> followed by `git submodule update --init` instead.)
> 
> Pros / Cons:
> 
> + Improves accessibility of documentation and encourages more devs to
> participate.
> + Helps to synchronize specific source versions with specific documentation
> versions.
> + Optional in situations where docs aren't needed (i.e.: build docker) and
> non-invasive to the krita-docs-org repo.
> - Slightly increases complexity of source repo, and may take a while to
> wrap your mind around submodules for people who are new to them.
> (Possibly others that I'm not thinking of right now.)
> 


-- 
https://www.krita.org




More information about the kimageshop mailing list