FeatureRequest: prominent reading access to this wiki #7

This is for the future when the Wiki grows and become more valuable than today.

Codebergs landing page and the blue menu bar need a link to Codebergs own documentation (this wiki?).

Also in the settings section "SSH / GPG keys" are links to GitHub's SSH help sizes.

On codeberg's landing page is a "Help" link just pointing to the gitea docu.

As soon we are happy with the content, we shall definitely do this! In preparation of a PR, please see the template file in https://codeberg.org/Codeberg/build-deploy-gitea/src/branch/master/etc/gitea/templates/custom/extra_links.tmpl.

I also added a link to the Community issue tracker landing page: https://codeberg.org/Codeberg/Community/src/branch/master/README.md

Can you deactivate the "Wiki" menu entry in "Codeberg/Community"?

Because we are using the "Codeberg/Documentation" wiki.

Or should we overthink this in general? As a DAU I would assume the codeberg docu in the general "Codeberg repository" what is in fact "Codeberg/Community" because the "Codeberg Issues Tracker" menu entry on the landing page pointing to there.

I agree with you. Moving these into the community wiki seems appropriate and improves user experience. @all: Any thoughts on this?

No other thoughts, so we can do it? ;)

hehe, looks like it :)

I am not familiar with gitea or what ever is needed to modify the link son the landing page.
Some other person need to do this job. ;)

should we overthink this in general

open to this too. Now that we have https://pages.codeberg.org/ and wiki content in markdown format, we might also consider alternative approaches that allow a more flexible layout?

Either way, improved content is probably more important than formatting we can update at any time...

I am not familiar with gitea or what ever is needed to modify the link son the landing page. Some other person need to do this job. ;)

I disabled the wiki tab in the Community repo.

@hw I would be happy to help and design a nice and friendly documentation page rendered from the Markdown.

I suggest we use Eleventy for generating the final HTML.
It's a very flexible, minimalistic static site generator that works well with all kinds of inputs, including Markdown. I've been using it for my personal website and the experience so far was great.

If you're interested, I can build a quick prototype and report back :)

_{(Don't mind me, I'm just a reference to track the progress in the related issue in the Community repo: Codeberg/Community#33 🤓)}

@lhinderberger : Have you seen this? #13

ping @n

No, haven't seen that yet - but great to see it's already being done :)

With #36 resolved, we can now think about whether we want to add a link to the documentation site https://docs.codeberg.org to the navigation bar or whether we want to wait until the Getting Started guide #26 is done.

PR to templates in https://codeberg.org/Codeberg/build-deploy-gitea/src/branch/master/etc/gitea/templates/custom/ welcome!

Will do. But should we wait until the Getting Started guide is ready (approx. at the end of the week)?

With #36 resolved, we can now think about whether we want to add a link to the documentation site https://docs.codeberg.org to the navigation bar

The nav bar is already quite crowded. We could replace Codeberg Issues with a link to the docs.

Will do. But should we wait until the Getting Started guide is ready (approx. at the end of the week)?

Sounds good to me. A blog post about the documentation would be good too!

We could replace Codeberg Issues with a link to the docs.

I would rather combine "Join Codeberg e.V." and "Donate" into "Support Codeberg" and leave "Codeberg Issues" in the menu, because Issues is a good way to get into contact and is very frequently used. As it serves more or less as a forum, it shouldn't be removed IMHO.

A blog post about the documentation would be good too!

Agreed 👍

With the Getting Started Guide now deployed, I'd usually write a pull request to build-deploy-gitea, but with Codeberg/Community#140 being unresolved, I'm unsure whether that would really be a good idea.

How should we move forward?

The PR linked above now adds a basic link to the title bar, in the style we use right now. This is not the ideal solution for horizontal growth and might be rejected because of that. But on the other hand it's better to have a link there now than to have no link at all.

The link to Documentation has now been deployed to the main page :)