Robin Shen opened 3 years ago
That feature would be great 👍
@robin We already have the build docs function of CI/CD
It needs documentation, and I did say I was going to look into it, but I have not found the time because of personal work which I have had to do.
@cooperspencer I am against this, as it would be too centralised, the current undocumented feature is more than useful, being able to pick any documentation server you like, whether it is mkdocs or docusaurus, and then a CI/CD task to deploy them to a wiki endpoint is far more powerful than having a dedicated wiki tab.
It is one of the main complaints I have against Github wikis, is that you can not properly contribute to them, and they are quite closed off and can't be rehosted elsewhere.
I like to be able to locally view documentation, which is why I maintain the
@polarian I get where you are comong from but do not share this opinion. I like to have everything in one place and not host many different services. Also I have no bandwidth issues whatsoever
Well then, that is problematic.
I guess if the wiki feature has the ability to be disabled, then I am more than happy to see it introduced, but if it is forced on the userbase, then I would be severely disappointed, as I do not feel we should be locked into using a single platform.
Git was designed to have multiple upstreams, we should not lock the userbase into a single instance.
Also if you add the wiki feature, at least make it "better" than github/gitlab by pushing it to a special directory within the repository allowing others to submit PR's related to the wiki, it could be called something like
I guess this feature would not be hard to implement, you already have markdown parsing, you just need to parse wiki related markdown and serve it a as a subpage of a repository.
@polarian that's an awesome idea for a wiki imho. Having something like a
@robin what do you think about this?
Agree with your guys here. I don't like GitHub/GitLab way of implicit wiki repository. Either a special directory like